spring mvc应用启动后访问控制器返回404，常因spring框架各模块版本不兼容（如spring web mvc 6.0.x与thymeleaf 3.1.x不匹配）或dispatcherservlet配置失效导致，需重点核查依赖版本一致性与组件注册完整性。
spring mvc应用启动后访问控制器返回404，常因spring框架各模块版本不兼容（如spring web mvc 6.0.x与thymeleaf 3.1.x不匹配）或dispatcherservlet配置失效导致，需重点核查依赖版本一致性与组件注册完整性。
在基于传统XML配置（web.xml + applicationContextMVC.xml）的Spring MVC入门项目中，出现“HTTP Status 404 – Not Found”且提示 “The origin server did not find a current representation for the target resource”，往往并非路由映射缺失或JSP路径错误，而是更底层的容器初始化失败——即 DispatcherServlet 根本未成功加载或其关联的HandlerMapping、ViewResolver等核心组件未能注册。这类问题在Spring 6+与较新生态组件（如Thymeleaf 3.1+）混用时尤为典型。
? 根本原因：Spring 6.x 与 Thymeleaf 3.1.x 的兼容性断裂
Spring Framework 6.0 起全面要求 Java 17+ 和 *Jakarta EE 9+（即 `jakarta.命名空间）**，而 Thymeleaf 3.1.1 虽已支持 Jakarta EE 9，但其官方兼容矩阵明确指出： ✅ **Thymeleaf 3.1.x 官方推荐搭配 Spring Framework 5.3.24+（非6.x）** ❌ Spring Framework 6.0.x（如6.0.5/6.0.6）与 Thymeleaf 3.1.x 存在隐式依赖冲突，尤其影响ViewResolver初始化和模板资源定位逻辑，导致DispatcherServlet` 启动时跳过视图解析器注册——此时即使Controller正确响应，最终也无法将Model渲染为JSP/HTML，请求直接落入404。
? 注意：该问题与Tomcat版本（9.0.73）、Maven插件（如maven-war-plugin）或web.xml配置无直接关系，而是Spring容器上下文在刷新阶段静默失败所致。
✅ 正确解决方案：降级Spring至5.3.x稳定分支
将 pom.xml 中所有Spring相关BOM依赖统一降级至 5.3.24（Spring 5最后一个维护版本，完全兼容Java 17 + Jakarta EE 8/9过渡层）：
<properties><spring.version>5.3.24</spring.version></properties><dependencies><dependency><groupid>org.springframework</groupid><artifactid>spring-webmvc</artifactid><version>${spring.version}</version></dependency><dependency><groupid>org.springframework</groupid><artifactid>spring-context</artifactid><version>${spring.version}</version></dependency><dependency><groupid>org.springframework</groupid><artifactid>spring-core</artifactid><version>${spring.version}</version></dependency><dependency><groupid>org.springframework</groupid><artifactid>spring-web</artifactid><version>${spring.version}</version></dependency><!-- Thymeleaf 3.1.1 可保留，与 Spring 5.3.x 完全兼容 --><dependency><groupid>org.thymeleaf</groupid><artifactid>thymeleaf-spring5</artifactid><version>3.1.1.RELEASE</version></dependency></dependencies>
⚠️ 关键检查点：
- 删除任何显式声明的 spring-beans、spring-aop 等子模块版本（由spring-webmvc传递依赖自动引入）；
- 若使用JSP，确保web.xml中
为org.springframework.web.servlet.DispatcherServlet，且 正确指向applicationContextMVC.xml； - 清理Maven本地仓库中可能残留的Spring 6.x快照包（执行 mvn clean dependency:purge-local-repository）；
- 重启IDE（IntelliJ/Eclipse）并重新部署到Tomcat，观察控制台是否输出 Mapped URL path [/hello] onto method ... —— 这是DispatcherServlet成功注册Handler的标志。
? 补充建议：面向未来的轻量替代方案
若希望长期避免此类兼容陷阱，建议逐步迁移至现代Spring Boot方式：
- 使用 spring-boot-starter-web（自动适配Spring 6.x + Jakarta EE 9）；
- 以@Controller + @ResponseBody替代XML配置；
- 用Thymeleaf 3.1.x + spring-boot-starter-thymeleaf（内置版本对齐）。
但对学习Spring MVC底层机制而言，精准控制Spring 5.3.x版本仍是理解DispatcherServlet生命周期、HandlerMapping与ViewResolver协作原理的最佳实践入口。
总结：404不是“找不到页面”，而是“没启动好调度器”。版本兼容性是传统Spring MVC项目的隐形地雷——坚持使用Spring 5.3.x系列，是兼顾Java 17、稳定性与教学清晰性的最优解。
