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
相关产品推荐
相关产品推荐

