Spring Boot集成LocalStack(SQS) Docker容器测试时遭遇java.lang.NoClassDefFoundError问题排查与解决

最近我在Spring Boot项目里尝试用本地Docker容器运行LocalStack（SQS）做集成测试，用Testcontainers的LocalStackContainer来和Docker交互，结果运行测试时直接抛出了NoClassDefFoundError，折腾了一番终于搞定，把过程分享给大家。

测试代码 #

我的测试类代码如下，问题出在初始化LocalStackContainer的那一行：

import org.testcontainers.containers.localstack.LocalStackContainer;
import org.testcontainers.utility.DockerImageName;

@SpringBootTest(classes = SqsConsumer.class)
public class SqsConsumerTest {

    public static LocalStackContainer localStackContainer = new LocalStackContainer(DockerImageName.parse("localstack/localstack:0.11.6"))
            .withServices(LocalStackContainer.Service.SQS);

    @BeforeClass
    public static void initLocalStack() throws IOException, InterruptedException {
        localStackContainer.start();
        localStackContainer.execInContainer("awslocal", "sqs", "create-queue", "--queue-name", "image-sqs");
    }
}

异常信息 #

运行测试后抛出的堆栈跟踪是：

java.lang.NoClassDefFoundError: com/amazonaws/auth/AWSCredentials
at br.com.imageprocessor.SqsConsumerTest.<clinit>(SqsConsumerTest.java:27)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.base/java.lang.reflect.Method.invoke(Method.java:568)
at org.junit.runners.model.FrameworkMethod$1.runReflectiveCall(FrameworkMethod.java:59)
at org.junit.internal.runners.model.ReflectiveCallable.run(ReflectiveCallable.java:12)
at org.junit.runners.model.FrameworkMethod.invokeExplosively(FrameworkMethod.java:56)
at org.junit.internal.runners.statements.RunBefores.invokeMethod(RunBefores.java:33)
at org.junit.internal.runners.statements.RunBefores.evaluate(RunBefores.java:24)
at org.junit.internal.runners.statements.RunAfters.evaluate(RunAfters.java:27)
at org.junit.runners.ParentRunner$3.evaluate(ParentRunner.java:306)
at org.junit.runners.ParentRunner.run(ParentRunner.java:413)
at org.junit.runner.JUnitCore.run(JUnitCore.java:137)
at com.intellij.junit4.JUnit4IdeaTestRunner.startRunnerWithArgs(JUnit4IdeaTestRunner.java:69)
at com.intellij.rt.junit.IdeaTestRunner$Repeater.startRunnerWithArgs(IdeaTestRunner.java:33)
at com.intellij.rt.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:221)
at com.intellij.rt.junit.JUnitStarter.main(JUnitStarter.java:54)
Caused by: java.lang.ClassNotFoundException: com.amazonaws.auth.AWSCredentials
at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:520)
... 18 more

初始依赖配置 #

我一开始配置的Maven依赖是这些：

<dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>sqs</artifactId>
</dependency>
<dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>sso</artifactId>
</dependency>
<dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>s3</artifactId>
</dependency>
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.13</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-all</artifactId>
    <version>1.10.19</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>localstack</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>testcontainers</artifactId>
    <scope>test</scope>
</dependency>

我已经确认本地的Docker容器运行状态正常，所以问题肯定出在依赖上。一开始我只引入了AWS SDK v2的依赖，但Testcontainers的LocalStack模块在配合旧版本LocalStack镜像（比如我用的0.11.6）时，需要依赖AWS SDK v1的类。

解决办法 #

添加AWS SDK v1的SQS依赖到Maven配置中即可解决问题：

<dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-sqs</artifactId>
    <version>1.12.142</version>
</dependency>

关键原因 #

这里要区分AWS SDK的两个版本：

• 我最初用的是AWS SDK v2（software.amazon.awssdk作为groupId）
• 但旧版本的LocalStack和对应的Testcontainers模块依赖的是AWS SDK v1的类（com.amazonaws作为groupId），比如报错里的com.amazonaws.auth.AWSCredentials就是v1里的类，所以必须补充这个依赖才能让测试正常运行。

内容的提问来源于stack exchange，提问作者Victor Hugo Pongolino