Java部署Spring到Tomcat完整步骤详解

本文详解了将Spring Boot和传统Spring MVC应用打包为WAR文件并成功部署到外部Tomcat的完整流程与关键避坑指南，涵盖版本兼容性要求（如Spring Boot ≥2.0及2.6+的特殊限制）、主类改造、Maven配置调整、web.xml替代方案、静态资源访问异常排查、404故障定位方法，以及从catalina.out到localhost日志的逐层调试技巧——帮你绕过“能打包却跑不通”的常见陷阱，真正实现一次部署、稳定上线。

Spring Boot 应用打 war 包部署到 Tomcat 的前提条件

Spring Boot 默认内嵌 Tomcat，打 jar 包直接运行；要部署到外部 Tomcat，必须改造成可部署的 war 包，且 Spring Boot 版本需 ≥ 2.0（2.6+ 有额外限制）。关键点不是“能不能”，而是“改哪几处”。

• 主启动类继承 SpringBootServletInitializer 并重写 configure()
• pom.xml 中将 spring-boot-starter-tomcat 的 改为 provided
• 打包类型改为 war
• 确保没有在 application.properties 中硬编码 server.port 或 server.servlet.context-path（外部 Tomcat 会接管）

传统 Spring MVC（非 Boot）项目部署时 web.xml 缺失问题

从 Spring 3.1 起支持基于 Java 配置的 Servlet 容器初始化，web.xml 不再必需。但若你用的是老项目或 Tomcat 7/8，又没配好初始化逻辑，会报 java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener 或 404。

• 确认 WEB-INF/lib 下包含 spring-web-x.x.x.RELEASE.jar
• 用 AbstractAnnotationConfigDispatcherServletInitializer 替代 web.xml：重写 getServletConfigClasses()、getRootConfigClasses()、getServletMappings()
• 若仍需 web.xml，最低要求至少声明 ContextLoaderListener 和 DispatcherServlet，且 contextConfigLocation 指向正确的配置类或 XML

部署后 404 或静态资源无法访问的常见原因

Tomcat 成功启动应用不代表请求能路由到 Controller —— 很多是 DispatcherServlet 没正确拦截，或静态资源路径被覆盖。

• 检查 webapp/ 目录结构是否符合规范：WEB-INF/web.xml（如有）、WEB-INF/classes/（含编译后的 class 和 application.properties）、static/ 或 resources/（静态文件）
• Spring Boot 项目若用了 @EnableWebMvc，会关闭默认的静态资源处理规则，需手动配置 WebMvcConfigurer.addResourceHandlers()
• Tomcat 9+ 默认禁用对 webapps/ROOT 外部路径的自动解压，确认 conf/server.xml 中 unpackWARs="true" 且应用名与 WAR 文件名一致（如 myapp.war → 访问 /myapp/）

调试部署失败时该看哪些日志和路径

别只盯着控制台红字，真正线索藏在 Tomcat 日志层级里。

• 先查 logs/catalina.out：看应用是否被识别、是否触发 ServletContext 初始化
• 再查 logs/localhost..log：记录每个 WebApp 的加载过程，含 ClassNotFound、Servlet 初始化失败等细节
• 确认 webapps/ 下生成的是解压目录（如 myapp/）还是仅留 myapp.war：后者说明自动部署失败，可能因 autoDeploy="false" 或磁盘空间不足
• 如果 Controller 方法没进断点，用 curl -v http://localhost:8080/myapp/actuator/health（Boot）或 /myapp/some-mapping 测试基础路由，排除前端代理或反向代理干扰

最易忽略的是：Spring Boot 2.6+ 默认禁用 RequestMappingHandlerMapping 对 / 的 fallback，若你依赖根路径映射，得显式配置 spring.mvc.throw-exception-if-no-handler-found=true 并捕获 NoHandlerFoundException，否则 404 不报错也不进日志。

理论要掌握，实操不能落！以上关于《Java部署Spring到Tomcat完整步骤详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！