【sa-token】 sa-token非 web 上下文无法获取 HttpServletRequest - 实践

Springboot cloud gateway集成sa-token中报错

cn.dev33.satoken.exception.NotWebContextException: 非 web 上下文无法获取 HttpServletRequest
at cn.dev33.satoken.spring.SpringMVCUtil.getRequest(SpringMVCUtil.java:45) ~[sa-token-spring-boot-starter-1.38.0.jar:?]

官网解释：

跟着官网解释没有解决内容。

场景分析

集成了gateway,高版本得gateway是非阻塞式得，是拿不到上下文得根本原因。

特性	阻塞式 Gateway	非阻塞式 Gateway
底层框架	Spring MVC，Servlet	Spring WebFlux，Netty/Undertow
线程模型	每个请求一个线程，阻塞 I/O	事件循环，少量线程，非阻塞 I/O
并发性能	受线程池大小限制，高并发下线程耗尽风险	高并发下更高效，适合 I/O 密集型任务
上下文对象	HttpServletRequest, HttpServletResponse	ServerWebExchange
编程模型	同步，命令式编程	异步，反应式编程（Mono/Flux）
适用场景	传统 Web 应用，I/O 操作简单	高并发、微服务、I/O 密集型（如 API 网关）
生态兼容性	兼容 Servlet 相关库（如 Sa-Token 默认配置）	需适配 WebFlux（如 Sa-Token 的 Redis 存储）

解决方案

1：替换原有pom 为

<dependency>
<groupId>cn.dev33</groupId>
<artifactId>sa-token-reactor-spring-boot-starter</artifactId>
<version>1.43.0</version>
</dependency>

2：增加全局配置

/**
* [Sa-Token 权限认证] 全局配置类
*/
@Configuration
public
class SaTokenConfigure {
/**
* 注册 [Sa-Token全局过滤器]
*/
@Bean
public SaReactorFilter getSaReactorFilter(
) {
return
new SaReactorFilter(
)
// 指定 [拦截路由]
.addInclude("/**"
) /* 拦截所有path */
// 指定 [放行路由]
.addExclude("/favicon.ico"
)
// 指定[认证函数]: 每次请求执行 
.setAuth(obj ->
{
System.out.println("---------- sa全局认证"
)
;
// SaRouter.match("/test/test", () -> StpUtil.checkLogin());
**加粗样式**
}
)
// 指定[异常处理函数]：每次[认证函数]发生异常时执行此函数 
.setError(e ->
{
System.out.println("---------- sa全局异常 "
)
;
return SaResult.error(e.getMessage(
)
)
;
}
)
;
}
}

3：测试

---------- sa全局认证
SA [INFO] -->: 账号 11111111 登录成功 (loginType=login), 会话凭证 token=27b235ff-efb4-4db6-9f91-b785a9884078

总结

请判断你的项目是 SpringMVC 环境还是 WebFlux 环境：
如果是 SpringMVC 环境就引入 sa-token-spring-boot-starter 依赖
如果是 WebFlux 环境就引入 sa-token-reactor-spring-boot-starter 依赖

如果你还无法分辨你是哪个环境，就看你的 pom.xml 依赖：
如果引入了spring-boot-starter-web就是 SpringMVC 环境。
如果引入了 spring-boot-starter-webflux 就是WebFlux环境。