Spring Boot项目无法导入AmazonS3类的问题排查求助

核心问题：AWS SDK V1和V2依赖冲突 #

你同时引入了AWS SDK V1（com.amazonaws:aws-java-sdk-s3）和AWS SDK V2（software.amazon.awssdk:aws-sdk-java），这两个版本的SDK完全不兼容，类路径里的重复/冲突类会让IDE无法正确识别你需要的AmazonS3类。

• AmazonS3是AWS SDK V1的核心类，包路径为com.amazonaws.services.s3.AmazonS3
• V2中对应的S3客户端是S3Client，包路径为software.amazon.awssdk.services.s3.S3Client
• 同时引入两个版本会导致类加载混乱，IDE只能识别到边缘类（比如你提到的AmazonopensearchserviceS3BackupMode），却找不到核心的AmazonS3

额外问题：编译版本不匹配 #

项目配置的java.version是17，但maven-compiler-plugin的source和target设为1.8，版本不一致会进一步加剧依赖识别问题。

修复步骤 #

方案1：保留AWS SDK V1（仅推荐维护旧项目） #

1. 删除V2依赖：移除pom.xml中的software.amazon.awssdk:aws-sdk-java
2. 保留V1的S3依赖：

<dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
    <version>1.11.1006</version>
</dependency>

3. 修正编译版本：把maven-compiler-plugin的source和target改为17：

<configuration>
    <source>17</source>
    <target>17</target>
    <!-- 其他注解处理器配置不变 -->
</configuration>

4. 刷新Maven依赖，重新导入com.amazonaws.services.s3.AmazonS3

方案2：切换到AWS SDK V2（推荐新项目使用，V1已进入维护模式） #

1. 删除V1依赖：移除pom.xml中的com.amazonaws:aws-java-sdk-s3
2. 替换为V2的S3模块（按需引入更轻量）：

<dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>s3</artifactId>
    <version>2.20.14</version>
</dependency>

3. 同样修正编译版本为17
4. 在代码中使用V2的S3Client替代V1的AmazonS3

收尾操作 #

修改完pom.xml后，执行Maven的clean和compile命令，或者在IDE中刷新Maven依赖，重新导入相关类即可解决识别问题。

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