Spring Boot应用Docker启动失败：类路径版本冲突问题

阿华AIGC实验室

2026-5-9

解决Spring Boot Docker镜像启动时的Tomcat依赖冲突问题

嘿，我来帮你搞定这个头疼的问题！你的核心问题是依赖版本不匹配导致的jar包冲突——在IDE里可能因为依赖解析的优先级没暴露问题，但Docker构建时会把所有依赖打包进镜像，冲突就直接炸出来了。

问题根源分析

从你的pom.xml和错误日志来看：

你的Spring Boot父项目用的是2.3.2.RELEASE，但你手动指定了spring-boot-starter-undertow为2.3.4.RELEASE，还把spring-security-test定在了5.4.0。这两个操作直接打破了Spring Boot的依赖管理体系，引入了不兼容的子依赖（就是报错里的Tomcat Coyote两个版本）。
就算你移除了Undertow，之前的依赖冲突残留或者其他指定版本的依赖依然会搞事情。

一步步解决

1. 乖乖跟着Spring Boot的依赖管理走

Spring Boot的父pom已经帮你把所有官方starter和相关依赖的版本都管好了，除非你有特殊需求，别手动指定这些依赖的版本：

删掉spring-boot-starter-undertow的version标签，让父pom来控制版本
删掉spring-security-test的version标签，Spring Boot会自动匹配对应版本的Security依赖

修改后的这两个依赖应该长这样：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-undertow</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.security</groupId>
    <artifactId>spring-security-test</artifactId>
    <scope>test</scope>
</dependency>

2. 显式排除Tomcat依赖（如果你用Undertow的话）

虽然Spring Boot默认会在引入Undertow时排除Tomcat，但有时候其他依赖可能偷偷把Tomcat带进来，你可以在spring-boot-starter-web里明确排除：

<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>

3. 清理+重新构建

先把本地Maven仓库的冲突依赖清掉：运行mvn clean install -U，强制更新所有依赖
重新构建Docker镜像：mvn spring-boot:build-image
启动容器测试一下

4. 查依赖树揪出漏网之鱼

如果还是有问题，运行mvn dependency:tree命令，看看依赖树里有没有tomcat-coyote和tomcat-embed-core的不同版本。找到引入冲突的那个依赖，然后给它加排除：

<dependency>
    <!-- 这里换成你发现的冲突依赖 -->
    <groupId>xxx</groupId>
    <artifactId>xxx</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-coyote</artifactId>
        </exclusion>
    </exclusions>
</dependency>