Spring Boot打war包部署到Tomcat需满足：版本≥2.0（2.6+有额外限制）；主类继承SpringBootServletInitializer并重写configure()；pom.xml中spring-boot-starter-tomcat设为provided且packaging为war；避免硬编码server.port和context-path。
Spring Boot 应用打 war 包部署到 Tomcat 的前提条件
Spring Boot 默认内嵌 Tomcat，打 jar 包直接运行；要部署到外部 Tomcat，必须改造成可部署的 war 包，且 Spring Boot 版本需 ≥ 2.0（2.6+ 有额外限制）。关键点不是“能不能”，而是“改哪几处”。
- 主启动类继承
SpringBootServletInitializer并重写configure() -
pom.xml中将spring-boot-starter-tomcat的<scope></scope>改为provided - 打包类型改为
<packaging>war</packaging> - 确保没有在
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 日志层级里。
立即学习“Java免费学习笔记（深入）”；
- 先查
logs/catalina.out：看应用是否被识别、是否触发ServletContext初始化 - 再查
logs/localhost.<date>.log</date>：记录每个 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 不报错也不进日志。
