You need to enable JavaScript to run this app. Spring Boot+Tomcat 8.5.53下CSRF Token随机过期403问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot+Tomcat 8.5.53下CSRF Token随机过期403问题咨询

同技术栈偶发CSRF无效报错的排查与落地解法

我在Spring Boot + Tomcat 8.5.x的线上生产环境遇到过完全一致的偶发Invalid CSRF Token报错,前后排查了两周定位完所有触发场景,全程没有关闭CSRF防护,把实际踩过的坑和对应解法列出来:

  • 多节点部署下的Session存储不一致问题
    如果你用了Spring Security默认的HttpSessionCsrfTokenRepository,这套机制的逻辑是把生成的CSRF Token存在用户的HttpSession中做比对校验。只要负载均衡策略没有做节点会话粘性,用户的写操作请求偶尔被路由到另一台没有对应Session数据的节点时,服务端根本找不到Session里存的原Token,就会直接判定请求携带的Token无效。
    这类问题完全没有固定复现规律,因为请求路由到哪个节点本来就由负载均衡策略动态决定;等用户刷新页面时,新的GET请求恰好路由回有自己Session的节点,重新生成和Session匹配的Token,功能就自动恢复,和你描述的故障特征高度吻合。
    对应解法:如果不想搭集中式Session同步,直接换成CookieCsrfTokenRepository,把CSRF Token存在HttpOnly=false的同域Cookie中,服务端校验时直接从Cookie读取值比对,从根源上消除节点间Session数据不一致的问题;如果必须保留Session存储Token的方案,就配置负载均衡的会话粘性规则,或者把所有Session存储迁移到Redis做集中管理,保证所有节点能读到同一份Session数据。
  • 后台Session超时导致的Token失配问题
    Spring Security的CSRF Token是和用户Session生命周期绑定的,只要Session因为超时被服务端主动销毁,服务端就会清空对应Session里的Token记录。但用户当前打开的页面是之前渲染好的,页面里的隐藏域、前端JS全局变量中存的旧Token不会主动更新,此时用户在旧页面上发POST/PATCH请求,携带的还是已经失效的旧Token,就会触发Invalid Token报错。
    这类问题用户完全感知不到Session已经在后台超时了,只有发写操作的时候才会触发校验失败,手动刷新重新走登录流程拿到新Token就恢复正常。而且因为GET请求默认不校验CSRF,所以报错只会集中在POST/PATCH这类写操作请求上,和你遇到的故障场景完全一致。
    对应解法:前端加全局403响应拦截,只要识别到CSRF Token无效的报错特征,就自动跳转回当前页面的刷新逻辑,不需要用户手动操作;同时把服务端Session超时时间和前端页面的空闲提醒逻辑做对齐,在用户Session快要过期的时候主动提示用户保存操作,减少用户在过期后触发旧请求的概率。
  • 多标签页操作导致的Token值过期问题
    如果前端把CSRF Token存在localStorage、或者JS全局缓存变量里,当用户开多个同域名的标签页时,只要其中一个标签页触发了重新登录、Session重建,Spring Security就会给新会话生成全新的CSRF Token,其他旧标签页里缓存的旧Token不会自动同步更新。用户切回旧标签页发写请求时,带的还是过期的旧Token,就会偶发校验失败。
    对应解法:不要把CSRF Token存在前端的持久化缓存里,每次发写请求时从当前页面的隐藏域、或者实时读取的同域Cookie里取最新的Token值,不使用缓存的旧值做请求头/参数拼接。

注:所有场景下都不需要通过关闭CSRF防护解决问题,只需要匹配实际的部署和使用场景调整Token的存储、同步逻辑即可。

内容的提问来源于stack exchange,提问作者Tom Bom

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 07:54:01