Spring MVC Student模块跳转路径拼接错误触发404,同配置Instructor运行正常
异常根因定位
该问题的核心触发逻辑为浏览器相对路径解析的基准路径不匹配,两个模块实现逻辑表面一致,但Student模块独有的路径配置差异,导致浏览器解析相对路径时的基准URL偏离预期。
核心规则说明
浏览器解析页面中相对路径的基准,为当前页面URL去掉最后一段路径后的剩余部分:
- 若当前落地URL为
/student/list,去掉最后一段list后的基准路径为/student/,拼接相对路径showFormForAddNewStudent会得到预期的/student/showFormForAddNewStudent - 若当前落地URL为带尾斜杠的
/student/list/,去掉最后一段空路径后的基准路径为/student/list/,拼接相对路径showFormForAddNewStudent就会得到错误的/student/list/showFormForAddNewStudent
Instructor模块功能正常,本质是访问/instructor/list时落地的URL没有带尾斜杠,基准路径符合预期。
触发Student模块异常的常见配置差异
- Student模块的列表接口映射配置了带尾斜杠的路径:比如StudentController中/list接口的注解写为
@GetMapping("/list/"),而Instructor模块对应接口是不带尾斜杠的@GetMapping("/list")。Spring MVC默认开启尾斜杠匹配时,访问不带尾斜杠的/student/list会触发301重定向到带尾斜杠的/student/list/,地址栏落地路径带尾斜杠,直接触发相对路径拼接错误。 - StudentController返回列表视图的代码存在路径笔误:比如返回值写为
return "student/list/",而Instructor模块对应返回值是不带尾斜杠的return "instructor/list",导致视图解析后的路径带尾斜杠。 - Web服务器/反向代理层的差异化重定向配置:比如Tomcat、Nginx针对
/student/list路径配置了强制跳转带尾斜杠的规则,但未对/instructor/list路径配置同样规则,导致仅Student模块触发路径重定向。
快速排查步骤
- 打开浏览器开发者工具的网络面板,访问学生列表页面时,查看初始请求的最终落地URL:如果落地URL为带尾斜杠的
/student/list/,即可确认是重定向导致的基准路径错误。 - 逐行对比两个模块的Controller类映射、接口方法映射、视图返回值,定位Student模块独有的尾斜杠配置项。
修复方案
- 最稳妥的通用修复:所有页面跳转、表单提交的路径不使用裸相对路径,拼接项目上下文前缀的绝对路径,比如:
- 新增按钮跳转地址写为
${pageContext.request.contextPath}/student/showFormForAddNewStudent - 新增表单的action写为
${pageContext.request.contextPath}/student/addNewStudent
该写法不受当前页面URL的尾斜杠影响,可从根源避免路径拼接错误。Instructor模块之前运行正常只是未触发异常场景,本身的裸相对路径写法存在隐患,可同步替换为统一写法。
- 新增按钮跳转地址写为
- 配置层面修复:修改Spring MVC路径匹配配置,关闭自动尾斜杠重定向,设置
useTrailingSlashMatch = false,让不带尾斜杠的路径不会被强制跳转。 - 最小改动修复:将裸相对路径修改为根相对路径,比如把按钮绑定的
showFormForAddNewStudent改为/student/showFormForAddNewStudent,这类路径以域名根目录为基准,不受当前页面路径层级的影响。
内容的提问来源于stack exchange,提问作者Stefan Jankovic
相关产品推荐
相关产品推荐

