使用AWS SDK for Java创建S3桶时遇NoClassDefFoundError问题求助

安全阿岳

2026-8-19

问题：使用Java API创建AWS S3桶时遇到NoClassDefFoundError错误

错误信息

Exception in thread "main" java.lang.NoClassDefFoundError: software/amazon/awssdk/protocols/query/internal/unmarshall/AwsXmlErrorUnmarshaller
at software.amazon.awssdk.protocols.xml.internal.unmarshall.AwsXmlErrorTransformer.(AwsXmlErrorTransformer.java:40)
at software.amazon.awssdk.protocols.xml.internal.unmarshall.AwsXmlErrorTransformer.(AwsXmlErrorTransformer.java:34)
at software.amazon.awssdk.protocols.xml.internal.unmarshall.AwsXmlErrorTransformer$Builder.build(AwsXmlErrorTransformer.java:113)
at software.amazon.awssdk.protocols.xml.AwsXmlProtocolFactory.createErrorTransformer(AwsXmlProtocolFactory.java:135)
at software.amazon.awssdk.protocols.xml.AwsS3ProtocolFactory.createErrorCouldBeInBodyResponseHandler(AwsS3ProtocolFactory.java:80)
at software.amazon.awssdk.services.s3.DefaultS3Client.createBucket(DefaultS3Client.java:1144)
at com.act.niti.main(niti.java:33)
Caused by: java.lang.ClassNotFoundException: software.amazon.awssdk.protocols.query.internal.unmarshall.AwsXmlErrorUnmarshaller
at java.net.URLClassLoader.findClass(URLClassLoader.java:382)
at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:355)
at java.lang.ClassLoader.loadClass(ClassLoader.java:351) ..

业务代码（Java 8环境）

try {
    Region region = Region.US_EAST_2; 
    S3Client s3 = S3Client.builder()
       .region(region)
       .build();
    S3Waiter s3Waiter = s3.waiter();
    CreateBucketRequest bucketRequest = CreateBucketRequest.builder()
           .bucket("abc")
           .build();
    
    s3.createBucket(bucketRequest); //creating s3 bucket
    System.out.println("bucket........abc");
    HeadBucketRequest bucketRequestWait = HeadBucketRequest.builder()
    .bucket("abc")
    .build();
    
    // Wait until the bucket is created and print out the response
    WaiterResponse<HeadBucketResponse> waiterResponse =
    s3Waiter.waitUntilBucketExists(bucketRequestWait);
    waiterResponse.matched().response().ifPresent(System.out::println);
    System.out.println("abc" +" is ready");
   
} catch (S3Exception e) {
    System.err.println(e.awsErrorDetails().errorMessage());
    System.exit(1);
}

当前POM配置

<dependencies>
    <dependency>
        <groupId>com.amazonaws</groupId>
        <artifactId>aws-java-sdk</artifactId>
        <version>1.11.570</version>
    </dependency>
    
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3</artifactId>
        <version>2.17.269</version>
    </dependency>
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>ec2</artifactId>
        <version>2.5.10</version>
    </dependency>       
    <!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.9.10</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-gamelift -->
    <dependency>
        <groupId>com.amazonaws</groupId>
        <artifactId>aws-java-sdk-gamelift</artifactId>
        <version>1.11.647</version>
    </dependency>
    

    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.8.2</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.8.2</version>
        <scope>test</scope>
    </dependency>

    <dependency>
        <groupId>org.junit.platform</groupId>
        <artifactId>junit-platform-commons</artifactId>
        <version>1.8.2</version>
    </dependency>
    <dependency>
        <groupId>org.junit.platform</groupId>
        <artifactId>junit-platform-launcher</artifactId>
        <version>1.8.2</version>
        <scope>test</scope>
    </dependency>

    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3-transfer-manager</artifactId>
        <version>2.17.103-PREVIEW</version>
    </dependency>
</dependencies>

解决方案

问题根源

AWS SDK V1和V2混用：代码使用的是AWS SDK V2的software.amazon.awssdk.services.s3.S3Client，但POM中同时引入了V1的com.amazonaws开头依赖，两者类库结构冲突。
V2内部版本不一致：S3依赖版本是2.17.269，但EC2是2.5.10、s3-transfer-manager是2.17.103-PREVIEW，版本差异导致缺少依赖类。

修复步骤

移除所有AWS SDK V1依赖：删除POM中com.amazonaws开头的两个依赖（aws-java-sdk和aws-java-sdk-gamelift），因为代码未使用V1 API。
统一AWS SDK V2所有依赖的版本：将EC2、s3-transfer-manager的版本统一为与S3相同的2.17.269（或选择一个稳定的V2版本保持一致）。

可选：使用AWS SDK V2 BOM管理版本：在POM的<dependencyManagement>中添加BOM，避免手动维护各组件版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>bom</artifactId>
            <version>2.17.269</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

添加后，各V2组件依赖可省略version标签，由BOM自动统一。

清理并重新构建项目：执行mvn clean install，确保依赖正确下载并生效。

修复后的POM示例（简化版）

<project>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>software.amazon.awssdk</groupId>
                <artifactId>bom</artifactId>
                <version>2.17.269</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>s3</artifactId>
        </dependency>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>ec2</artifactId>
        </dependency>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>s3-transfer-manager</artifactId>
        </dependency>

        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.9.10</version>
        </dependency>

        <!-- 测试依赖保持不变 -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>5.8.2</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>5.8.2</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-commons</artifactId>
            <version>1.8.2</version>
        </dependency>
        <dependency>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-launcher</artifactId>
            <version>1.8.2</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

内容的提问来源于stack exchange，提问作者Nitin Punekar

使用AWS SDK for Java创建S3桶时遇NoClassDefFoundError问题求助

错误信息 #

业务代码（Java 8环境） #

当前POM配置 #

问题根源 #

修复步骤 #