Spring Boot连AWS S3创建BasicAWSCredentials报SecurityException解决方法
问题根因
这个异常本质是JVM类加载阶段触发了包签名校验规则:
当JVM加载同一个包下(本次涉及的是com.amazonaws.auth包)的多个类时,如果发现这些类来自不同的、签名信息不匹配的Jar包,就会直接抛出该SecurityException。
对应到AWS SDK的使用场景,触发问题的直接原因如下:
- 类路径下存在多份包含
com.amazonaws.auth.BasicAWSCredentials类的Jar包,且这些Jar包的签名校验信息不一致 - 最常见场景是项目引入了多个版本的AWS Java SDK v1依赖(包名前缀为
com.amazonaws),不同版本的SDK Jar都带有AWS官方签名,但因为版本差异,签名校验值不匹配,被JVM拦截 - 次要场景是本地Maven/Gradle仓库缓存的SDK Jar文件损坏、被篡改,导致签名信息和同包下正常加载的类不匹配
补充说明:AWS SDK v2的包名前缀为
software.amazon.awssdk,和v1的com.amazonaws包路径完全隔离,即便同时引入也不会触发这个签名冲突,问题必然出在v1版本的多Jar冲突上。
对应解决方式
- 第一步:定位类路径下的依赖冲突
运行Maven依赖树命令排查所有AWS相关依赖:mvn dependency:tree -Dincludes=com.amazonaws**
从输出结果中找到所有不同版本的aws-java-sdk-core(承载BasicAWSCredentials类的核心包),记录下所有传递引入该包的上游依赖。 - 第二步:统一SDK版本,消除冲突
- 优先通过
dependencyManagement引入AWS官方的版本管控BOM(aws-java-sdk-bom),统一指定所有v1版本AWS SDK的版本,所有业务中引入的AWS相关依赖(比如aws-java-sdk-s3)都不单独写版本号,完全跟随BOM版本,避免版本错配。 - 对传递引入旧版SDK核心包的第三方依赖,通过排除标签移除冲突的
aws-java-sdk-core依赖,保证类路径下仅存在一个版本的AWS SDK核心包。
- 优先通过
- 第三步:清理损坏的本地缓存
删掉本地仓库中~/.m2/repository/com/amazonaws目录下的所有缓存文件,重新拉取依赖,避免Jar文件损坏导致的签名校验失败。
内容的提问来源于stack exchange,提问作者RandomUser
相关产品推荐
相关产品推荐

