Vaadin外部Tomcat生产部署需继承SpringBootServletInitializer吗？

配置必要性结论 #

让Spring Boot启动类继承SpringBootServletInitializer，是所有Spring Boot项目打包为WAR格式、部署到外部独立Servlet容器（包括外部Tomcat、独立Jetty等）的强制要求，属于Spring Boot框架层面的通用部署规范，和使用的Vaadin V22版本无直接绑定关系。

两种场景运行逻辑的差异直接导致了配置要求的不同：

• IntelliJ IDEA内置Tomcat运行项目时，实际走的是Spring Boot内嵌容器启动链路，直接执行项目main方法拉起完整应用，不需要依赖外部容器提供的SPI初始化入口，因此不做继承配置也能正常运行。
• 独立外部Tomcat部署WAR包时，容器不会主动调用Spring Boot项目的main方法，只会遵循Servlet 3.0+规范扫描应用内的Servlet初始化实现。SpringBootServletInitializer是Spring Boot官方提供的外部容器适配层，负责在外部容器环境下完成Spring应用上下文初始化、Vaadin相关Servlet与Filter注册、项目配置加载等核心流程，缺少这个继承关系，外部容器无法正确识别并加载应用组件，必然出现启动报错。

默认模板未带该配置的原因 #

start.vaadin.com默认生成的是基于内嵌容器的可执行JAR包项目模板，默认运行场景为直接通过启动命令运行JAR包，因此不需要添加该继承配置。如果在项目生成阶段主动选择打包格式为WAR，生成的启动类代码会自动带上extends SpringBootServletInitializer的对应写法。

默认适用于JAR部署的启动类写法：

public class Application implements AppShellConfigurator {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

适配外部Tomcat WAR部署的启动类写法：

public class Application extends SpringBootServletInitializer implements AppShellConfigurator {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

文档相关说明 #

你提到的Vaadin生产构建文档，内容核心聚焦在Vaadin框架本身的生产模式配置，包括前端资源压缩混淆、开发调试接口关闭、生产模式参数开启等Vaadin专属逻辑。WAR包外部容器部署属于Spring Boot层面的通用部署规则，相关说明原本归属Spring Boot官方部署文档范畴，但Vaadin的生产部署相关文档确实没有同步提示这个Spring Boot侧的必要前置配置，容易给仅参考Vaadin文档做部署的开发者造成障碍，存在补充提示的必要。

内容的提问来源于stack exchange，提问作者microwth