集成JWT后Spring Boot+ExtJS项目欢迎页加载返回401问题咨询
核心根因
浏览器原生全页导航请求(window.location 赋值、a标签点击、原生表单提交)属于浏览器内核直接发起的请求,没有任何前端API可以给这类请求自定义附加请求头,这就是存了localStorage的token之后直接跳/welcome会401的原因——请求里根本没带认证信息,JWT过滤器直接拦截返回未授权。
可行的解决路径
1. 修复Cookie传Token的兼容性问题(推荐,最贴合现有架构)
之前尝试写Cookie失败,核心原因是Tomcat9默认遵循RFC 6265规范校验Cookie合法性,Cookie值不允许包含空格。之前代码里写入的Cookie值是Authorization=Bearer xxx.yyy.zzz,其中Bearer和token之间的空格属于非法字符,Tomcat会直接丢弃这个Cookie,根本不会传递到JWT过滤器中。
修正方案:
- 写入Cookie时不要存带
Bearer前缀的值,直接把纯JWT token存进去,同时设置好过期时间、path=/、SameSite=Lax属性,不需要强行设httpOnly(如果需要后续JS读取的话); - 修改自行编写的
JWTRequestFilter逻辑,除了从Authorization请求头读token,增加从对应Cookie中读取纯token的分支,读出来之后手动拼接成Bearer xxx格式再走原有校验逻辑; - 存完Cookie之后再走正常的
window.location="/welcome"跳转,浏览器会自动携带Cookie发起请求,过滤器就能正常识别认证信息。
2. 用带认证头的AJAX请求拉取欢迎页内容,替换DOM渲染
之前用XMLHttpRequest拿到/welcome的HTML内容没做后续处理是正常的,不需要手动拆DOM元素逐块填充,直接用拿到的完整HTML替换当前文档即可,渲染效果和原生跳转完全一致:
- 登录成功拿到token之后,先把token存在localStorage中;
- 不要直接执行全页跳转,改用带自定义请求头的GET请求拉取/welcome的页面内容;
- 拿到完整HTML响应后,直接替换整个文档的内容,触发浏览器正常渲染、执行页面内的脚本逻辑。
参考实现代码:
// 登录成功的success回调内,存完token后 const authToken = window.localStorage.getItem("Authorization"); $.ajax({ url: "/welcome", type: "GET", beforeSend: function(xhr) { xhr.setRequestHeader("Authorization", authToken); }, success: function(pageHtml) { // 替换整个文档内容,实现和原生跳转一致的效果 document.open(); document.write(pageHtml); document.close(); } });
额外适配提示:欢迎页加载完成后,可以配置全局AJAX拦截规则,让后续ExtJS、jQuery发起的所有数据接口请求自动从localStorage读取token并附加到请求头,不需要逐接口手动写:
$.ajaxSetup({ beforeSend: function(xhr) { const token = window.localStorage.getItem("Authorization"); if (token) { xhr.setRequestHeader("Authorization", token); } } });
3. 低适配成本的临时方案(不推荐长期使用)
如果短期内没办法改Cookie格式、也不想改DOM替换逻辑,可以在JWT过滤器里增加对URL查询参数携带token的支持:
- 登录成功后跳转时把token拼在地址参数上:
window.location.href = "/welcome?auth=" + encodeURIComponent(纯token); - 过滤器里读请求的
auth参数值,拼接成Bearer格式完成校验。
注意这种方式的风险:token会留在浏览器历史记录、服务器访问日志、其他页面的Referer头中,泄露风险较高,仅适合临时调试用。
无效实现说明
之前代码里注释掉的两种实现方式是完全无效的:
- 往head里插meta标签写Authorization信息:浏览器不会解析meta标签的内容拼成HTTP请求头;
- 往Cookie里写带Bearer前缀的带空格值:Tomcat9会直接识别为非法Cookie格式丢弃,传递不到后端。
内容的提问来源于stack exchange,提问作者It Grunt
相关产品推荐
相关产品推荐

