SpringBoot中Testcontainers Kafka容器抛出NoClassDefFoundError求助

问题原因 #

java.lang.NoClassDefFoundError: com/github/dockerjava/api/exception/DockerException 错误的核心是项目运行时找不到docker-java-api包中的核心类。Testcontainers底层依赖docker-java组件与Docker引擎交互，但当前Maven依赖配置中，要么是依赖传递被阻断，要么是缺少显式的docker-java相关依赖，导致该类无法被正常加载。

解决方案 #

方案一：显式添加docker-java-api依赖 #

在pom.xml的<dependencies>节点中添加以下依赖（版本需与Testcontainers 1.17.6兼容，对应版本为3.2.12）：

<dependency>
    <groupId>com.github.dockerjava</groupId>
    <artifactId>docker-java-api</artifactId>
    <version>3.2.12</version>
    <scope>test</scope>
</dependency>

方案二：使用Testcontainers BOM统一管理依赖版本（推荐） #

通过BOM（物料清单）可以自动维护Testcontainers及其所有依赖的版本一致性，避免手动匹配版本带来的冲突问题。

1. 在pom.xml中添加dependencyManagement节点：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.testcontainers</groupId>
            <artifactId>testcontainers-bom</artifactId>
            <version>1.17.6</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2. 修改现有Testcontainers依赖，移除版本号（版本由BOM统一管控）：

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>testcontainers</artifactId>
    <scope>test</scope>
    <exclusions>
        <exclusion>
            <artifactId>commons-compress</artifactId>
            <groupId>org.apache.commons</groupId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>kafka</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>junit-jupiter</artifactId>
    <scope>test</scope>
</dependency>

额外检查 #

添加依赖后，执行mvn clean install -U命令强制更新Maven依赖，确保本地仓库中存在对应的jar包。如果问题仍存在，可排查是否有其他依赖排除了docker-java相关组件。

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