在spring cloud gateway中应使用reactor context替代threadlocal传递权限上下文，因其与mono/flux绑定、不可变且随数据流传播；需在globalfilter中鉴权后通过contextwrite写入用户信息，下游服务通过subscribercontext或reactivesecuritycontextholder安全读取。
在反应式网关（如 Spring Cloud Gateway）中，不能依赖传统的 ThreadLocal 来传递用户权限上下文——因为 WebFlux 的事件循环模型会在线程池中复用线程，请求可能在不同线程间切换，ThreadLocal 会丢失或污染上下文。
用 Reactor Context 替代 ThreadLocal
Reactor 提供了 Context 机制，它是与每个 Mono/Flux 绑定的不可变、作用域受限的键值存储，天然适配异步非阻塞链路，是反应式编程中传递安全上下文的正确方式。
- 上下文在订阅时注入，随数据流传播，不依赖线程绑定
- 每次调用
contextWrite()是叠加，contextRead()是读取，支持嵌套和覆盖 - 需在网关过滤器中尽早写入（如鉴权后），下游服务通过 WebClient 或自定义拦截器读取
网关层注入权限上下文（GlobalFilter 示例）
在 GlobalFilter 中解析 token 后，将用户 ID、角色、租户等信息写入 Reactor Context：
return chain.filter(exchange)
.contextWrite(ctx -> ctx.put("user_id", userId)
.put("roles", roles)
.put("permissions", perms));
注意：不要直接 put 原始对象（如 UserPrincipal），建议序列化为不可变结构（如 Map<string object></string> 或专用 DTO），避免跨服务反序列化风险。
下游服务安全读取并桥接到业务上下文
下游 Spring Boot WebFlux 服务需在 WebFilter 或 HandlerInterceptor 中从 Reactor Context 提取，并按需挂载到当前请求生命周期内：
- 使用
ServerWebExchange.getAttributes().put()存入 exchange 属性（仅限当前请求生命周期） - 若需在响应式 Service 层使用，可通过
Mono.subscriberContext()获取并转换为业务对象 - 禁止在
doOnNext等回调中修改全局状态或写入静态ThreadLocal，否则破坏反应式契约
避免常见陷阱
以下操作会破坏上下文一致性：
- 在
flatMap内部新建 Mono/Flux 但未传播 context（需显式subscriberContext()） - 调用阻塞式 API（如 JDBC、RestTemplate）后未恢复 context（应改用
publishOn(scheduler)+ 显式透传） - 将 Reactor Context 直接转成
SecurityContext并塞入 Spring Security 的ReactiveSecurityContextHolder以外的位置
真正安全的做法是：全程使用 ReactiveSecurityContextHolder.getContext() 写入和读取，它底层已基于 Reactor Context 封装，与 Spring Security 6.x 深度集成。
