在测试小程序连接测试环境的时候发现登录时后端总会提示用户未登录,即获取不到登录信息。

后端响应:{"code":400,"data":false,"message":"NOT_LOGIN","timestamp":"1759376786448"}

这段信息来自登录拦截器中,代码如下:

我查看了系统日志,发现登录是没有问题,但是获取用户信息的接口是异常的,提示401。

然后我又更换了接口地址,改为本地运行,发现一切正常。那我就认为应该是StpUtil.isLogin()这里出现问题了。

satoken做前后端分离项目时,在小程序端由于没有cookie因此需要把token信息写在请求头中,这样传到后端之后,后端的处理不用做任何改变就能达到和web端一样的效果。

所以这里没有获取到登录信息那大概率就是请求头的token无法传到后端。

由于本地试过没有问题,而测试环境是通过nginx反向代理的,问题应该出现nginx上,最后查了资料可算破案了(资料链接)。

具体来说就是nginx的配置问题:

nginx 默认会忽略名称中包含下划线(_)的请求头(我的后端的token键名就是star_finding),这是导致 Linux 服务器端无法接收 Token、登录失败的核心原因。

一、问题根源:Nginx 的 underscores_in_headers 配置

Nginx 有一个默认关闭的配置项 underscores_in_headers,作用是:

  • 默认值(off):忽略所有名称包含下划线的请求头(认为这类头是 “非标准头”,可能存在安全风险);
  • 开启(on):允许接收和转发名称包含下划线的请求头。
  • 你的请求头 star_finding 包含下划线,在默认配置下被 Nginx 过滤,导致后端服务(Spring Boot)根本接收不到该头,最终 Sa-Token 因 “无 Token” 判定为未登录。

二、解决方案:在 Nginx 中开启 underscores_in_headers

只需在 Nginx 配置的HTTP块中添加下面这行即可:

underscores_in_headers on;

或者可以更改键名为不带_的。 if (!StpUtil.isLogin()) { log.info("用户未登录"); Result error = Result.error("NOT_LOGIN"); String notLogin = JSONObject.toJSONString(error); response.getWriter().write(notLogin); response.setStatus(HttpServletResponse.SC_UNAUTHORIZED); return false; }