用途:面向微服务架构的鉴权方案,基于 sa-token-doc/micro/ 文档整理,基础登录与权限注解鉴权需配合 sa-token 技能使用。
主要能力:Same-Token 机制实现内部服务外网隔离,防止绕过网关直接访问子服务;SpringCloud Gateway 集中式登录与权限校验;Reactor/WebFlux 集成(SaReactorFilter);基于 Redis 的分布式 Session 共享;Feign 内部调用携带 Same-Token;Dubbo/gRPC 跨服务上下文传播;Same-Token 定时刷新并支持新旧 Token 双轨并行。
架构与流程:客户端 → Gateway(校验登录并注入 Same-Token)→ 子服务(校验 Same-Token),子服务间 Feign 调用同样携带 Same-Token。步骤为:Gateway 用响应式依赖、子服务用 Servlet 依赖;所有服务连接同一 Redis;Gateway 通过 SaReactorFilter 统一鉴权并注入 Same-Token;子服务通过 SaServletFilter 校验;RPC 调用传递 Same-Token;定时刷新保证高可用。
限制:所有服务需共享同一 Redis;Gateway 需 Reactor 依赖,子服务需独立 Sa-Token 依赖;SaReactorFilter 与 SaServletFilter 不可混用;Gateway 误用 Servlet 依赖会报错;Same-Token 默认有效期 86400 秒,生产环境须配置定时刷新,刷新期间存在短暂双 Token 并行;分布式 Session 存储对象需实现序列化;子服务直接暴露外网时必须配置 Same-Token 校验。SSO、OAuth2.0 与单体应用不在本技能范围内。本技能不收集、存储或传输用户数据。