Docker中Tomcat部署Spring Boot应用启动报错排查求助

1. 确认Spring Boot与Tomcat版本兼容性 #

Spring Boot 2.4及以上版本官方适配Tomcat 9.x，但要确保项目依赖的Spring Boot版本和Tomcat 9.0.58无兼容性问题。执行以下命令查看项目依赖树，检查spring-boot-starter-web内置的Tomcat版本：

mvn dependency:tree

如果项目内置Tomcat版本和容器中的9.0.58不一致，可能引发类加载冲突，必须排除内置Tomcat依赖。

2. 排除Spring Boot内置Tomcat并适配外部Tomcat #

因为是部署到外部Tomcat容器，必须移除Spring Boot自带的Tomcat依赖，并添加Servlet API依赖：

Maven配置 #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- 引入Servlet API（外部Tomcat已提供，设为provided） -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>

修改启动类 #

启动类需继承SpringBootServletInitializer，适配外部Tomcat的部署规范：

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

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

最后确保打包格式为war，在pom.xml中设置：

<packaging>war</packaging>

3. 检查Dockerfile配置正确性 #

确保Dockerfile正确处理war包部署，示例配置：

FROM tomcat:9.0.58-jdk11-openjdk

# 清理Tomcat默认webapps目录
RUN rm -rf /usr/local/tomcat/webapps/*

# 复制本地打包好的war包到Tomcat webapps目录，命名为ROOT.war（默认访问根路径）
COPY target/your-app-name.war /usr/local/tomcat/webapps/ROOT.war

EXPOSE 8080
CMD ["catalina.sh", "run"]

注意：构建镜像前必须先执行mvn clean package生成正确的war包，且COPY路径要和本地war包位置匹配。

4. 排查PropertyPlaceholder配置冲突 #

• 检查项目中是否自定义了PropertyPlaceholderConfigurer bean，这会和Spring Boot自动配置的PropertyPlaceholderAutoConfiguration冲突，建议移除自定义实现，改用@PropertySource加载配置文件。
• 检查application.properties/application.yml中是否存在格式错误的占位符（比如未闭合的${}），或引用了不存在的配置键，这类错误会导致自动配置处理失败。

5. 分析依赖树定位冲突依赖 #

导出完整依赖树并搜索冲突点：

mvn dependency:tree > dependency-tree.txt

在生成的文件中搜索spring-boot-autoconfigure和property-placeholder相关依赖，查看是否有重复引入、版本不一致的情况（比如第三方依赖引入了旧版本的Spring Boot自动配置包）。如果发现冲突，用<exclusions>排除多余的依赖。

6. 开启Debug日志查看自动配置决策细节 #

在Docker容器启动时添加JVM参数-Ddebug，Spring Boot会输出自动配置的详细决策日志，能明确看到PropertyPlaceholderAutoConfiguration是因何种条件不满足而失败。修改Dockerfile添加参数：

ENV CATALINA_OPTS="-Ddebug"
CMD ["catalina.sh", "run"]

启动容器后查看日志，重点关注ConditionEvaluationReport部分，里面会列出自动配置类的生效/失效原因。

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