SpringBootServletInitializer是外部Tomcat部署WAR包时必需的，它使启动类继承并重写configure方法以注册SpringApplication，同时需改pom为war包、tomcat依赖scope设为provided，并确保Tomcat版本与Spring Boot兼容（2.x配Tomcat 9，3.x配Tomcat 10.1）。
为什么 SpringBootServletInitializer 是必须的
外部 Tomcat 启动时靠 ServletContainerInitializer 加载应用，而 Spring Boot 默认打包成可执行 JAR，内嵌容器（如 Tomcat）直接启动 SpringApplication，绕过了 Servlet 规范的初始化流程。不继承 SpringBootServletInitializer，外部 Tomcat 就找不到你的 Spring 上下文入口，会报 404 或直接跳过加载。
它本质是重写了 configure 方法，把你的主类注册为 ServletContext 初始化器，并触发 SpringApplication.run() 的等效逻辑 —— 这步不能省，也不能靠配置替代。
- 必须让启动类（含
@SpringBootApplication的那个类）继承SpringBootServletInitializer - 必须重写
configure方法并返回builder.sources(YourApplication.class) - 如果用了多模块，确保该类在 WAR 包的
WEB-INF/classes/下可被扫描到
打包成 WAR 而不是 JAR 的关键改动
Spring Boot 默认打 JAR，要部署到外部 Tomcat，必须改成 WAR，否则即使继承了 SpringBootServletInitializer，Tomcat 也压根不会尝试加载它。
改 pom.xml 两处：一是 <packaging>war</packaging>；二是把 spring-boot-starter-tomcat 的作用域设为 provided，否则会和外部 Tomcat 冲突，常见报错是 java.lang.IllegalStateException: Tomcat servlet container not present 或启动时反复抛 NoClassDefFoundError。
-
<packaging>war</packaging>必须放在pom.xml根节点下，不能漏 -
spring-boot-starter-tomcat的<scope>provided</scope>缺失会导致 WAR 包里自带 Tomcat 类，与外部容器冲突 - 不要手动删
target目录再打包，Maven clean 一定要做，否则旧 JAR 残留可能被误打包进 WAR
外部 Tomcat 的版本兼容性陷阱
Spring Boot 2.5+ 默认要求 Servlet 4.0+，对应 Tomcat 9.0.31+；Spring Boot 3.x 强制要求 Servlet 5.0+，只支持 Tomcat 10.1.x（注意：Tomcat 10.0.x 是 Servlet 4.0，不兼容）。
典型症状是启动时报 java.lang.NoClassDefFoundError: jakarta/servlet/ServletContext（Boot 3）或 javax/servlet/ServletContext（Boot 2），本质是包名迁移（Java EE → Jakarta EE）没对齐。
- Spring Boot 2.x → 用 Tomcat 9.x（
javax.*包） - Spring Boot 3.x → 必须用 Tomcat 10.1.x（
jakarta.*包），Tomcat 10.0.x 不行 - 别信“改个包名就行”，Tomcat 二进制本身不兼容，强行替换 class 会引发更多反射失败
部署后 404 的常见定位路径
WAR 成功放到 webapps/、Tomcat 启动无异常，但访问始终 404，大概率不是代码问题，而是上下文路径或 DispatcherServlet 注册失败。
先看 Tomcat 日志里有没有 “Starting Servlet web application” 或 “Mapped URL pattern [/]” 这类日志；再确认你访问的路径是否带了 WAR 包名（比如包名是 myapp.war，默认上下文路径就是 /myapp，而不是 /）；最后检查 application.properties 里有没有误配 server.servlet.context-path 导致双重嵌套。
- 检查
logs/catalina.out是否出现Completed initialization in字样，没有说明 Spring 上下文根本没起来 - 确认 WAR 包名不含特殊字符或大写字母，部分 Tomcat 版本对
MyApp.war会自动转成myapp上下文，造成预期外的路径 -
spring.mvc.servlet.path和server.servlet.context-path别同时设，容易叠加出像/api/api/hello这种诡异路径
真正卡住的地方往往不在代码，而在 WAR 包结构是否干净、Tomcat 版本是否真的匹配、以及日志里那行不起眼的 “No Spring WebApplicationInitializer types detected” —— 它比任何 500 错误都更值得盯紧。
