杜明洋

第 1 步 / 共 5 步

系统总览

三类客户端 → 网关 → 服务 → 基础设施

1. 一次请求从门户经网关到产品服务

服务之间同步读走 Feign，跨服务写只走 RocketMQ 事务消息。

第 2 步 / 共 5 步

统一登录

门户 → 统一登录页 → PKCE 换令牌 → 单点登录

1. 访客在门户点登录
2. 跳到认证服务的统一登录页（登录页与认证服务同源，按客户端切换品牌）
3. 授权码加 PKCE 换令牌，访问令牌只在内存
4. 再打开词易背时静默续期、不再登录（单点登录）

桌面客户端走系统浏览器加本机回调，手机 App 走运营商一键登录换授权码；一个账号最多 6 台设备在线，会话撤销由网关拦截。

第 3 步 / 共 5 步

框架分层

官方组件 → mars-cloud-framework → 各服务

不改官方源码，在官方能力之上用 starter 固定约定：官方组件提供机制，starter 固定默认值、命名规则、上下文透传与错误码，服务只声明依赖、不重复配置。网关用 WebFlux，其余服务用 Servlet；依赖只能从服务指向框架，服务之间不加 Maven 依赖。

第 4 步 / 共 5 步

一次请求经过的框架能力

1. 管理后台带访问令牌请求通知列表，进入网关。
2. 网关验签（security starter，WebFlux 装配）。
3. 网关查会话撤销名单（网关自身代码，不算框架能力）。
4. 按客户端地址限流，规则来自 Nacos（sentinel starter）。
5. 经 Nacos 发现实例并转发，透传链路上下文（nacos starter、observability starter）。
6. 通知服务再次验签、建立调用方身份，再做方法鉴权（security starter，Servlet 装配）。
7. 经 Feign 向管理权限服务请求判定，只转发当前令牌（security-feign、feign starter）。
8. 包装成统一响应信封，异常转错误码；日志带 traceId（mvc starter、observability starter）。

第 5 步 / 共 5 步

跨服务写：账号注销的事务消息

1. 认证服务经事务发布模板发送半消息（rocketmq starter）。
2. 执行本地事务后提交；失败回滚，结果未定时由消息队列回查（rocketmq starter）。
3. 通知、管理权限、LingAI 三个服务各自消费，恢复链路与调用方身份（rocketmq starter）。
4. 各服务按业务键幂等清理本服务数据（服务自身代码）。
5. 用事务消息回报清理结果，认证服务汇总（rocketmq starter）。
6. 消费失败由消息队列重投最多 16 次，之后进入死信队列（rocketmq starter 默认值）。