Tomcat 10无法部署Spring Boot 3应用，无报错求助

1. 校验Spring Boot WAR打包核心配置 #

Spring Boot 3.x部署到外部Tomcat必须满足两个关键配置，缺一不可：

• 主类需继承SpringBootServletInitializer并重写configure方法：

@SpringBootApplication
public class YourAppApplication extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(YourAppApplication.class);
    }

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

• pom.xml需将内嵌Tomcat设为provided，避免与外部Tomcat类冲突：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

同时确认打包类型为war，且插件配置指定主类：

<packaging>war</packaging>
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>com.yourpackage.YourAppApplication</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 排查cit-security库兼容性问题 #

• 确认该库基于Jakarta EE开发：Tomcat 10.x仅支持jakarta.servlet.*系列API，完全废弃旧的javax.servlet.*，若cit-security依赖Java EE相关包，会导致类加载静默失败
• 检查cit-security的pom.xml：是否包含与Tomcat 10.x冲突的依赖（如旧版servlet-api、tomcat-core等），此类依赖需排除或替换为Jakarta版本
• 验证库的Spring Boot版本适配性：确认cit-security明确支持Spring Boot 3.1.2版本

3. 检查容器内Tomcat配置与日志 #

• 验证WAR部署路径：确认WAR包已放入Tomcat的webapps目录，且conf/server.xml的Host节点开启autoDeploy="true"和unpackWARs="true"
• 查看更细粒度日志：除catalina.out外，检查localhost.log和localhost_access_log.*.txt，这些日志常记录catalina.out遗漏的启动细节
• 排查权限问题：确保WAR包及解压后的目录属于Tomcat运行用户（通常为tomcat），权限不足会导致无法读取配置或加载类
• 临时关闭全局错误页面：注释conf/web.xml中的全局错误页面配置，避免掩盖真实报错

4. 手动验证WAR包有效性 #

• 本地Tomcat测试：在本地安装的Tomcat 10.1.11实例中部署该WAR，排除容器环境本身的问题
• 检查WAR结构：用jar -tvf your-app.war命令查看包内结构，确认WEB-INF/lib无内嵌Tomcat依赖、WEB-INF/classes包含主类与配置文件、WEB-INF/web.xml配置正确（Spring Boot默认生成，自定义时需校验）

5. 启用Spring Boot调试日志 #

在application.properties中添加日志配置，增强启动时的日志输出：

logging.level.org.springframework=DEBUG
logging.level.jakarta.servlet=DEBUG

重新打包部署后，从日志中定位启动过程中的静默失败节点

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