Spring Boot对接S3部署Heroku时遇连接拒绝错误求助

问题概述 #

服务器接收客户端文件名后生成S3预签名URL返回，本地IntelliJ配置IAM凭证与Region可正常运行，但部署至Heroku后调用/products/upload接口返回500错误，日志显示无法加载AWS凭证、连接被拒绝。

错误原因分析 #

1. 配置变量与代码属性不匹配：代码中使用spring.cloud.aws.*系列配置属性，但Heroku配置变量名称为AWS_*，导致Spring无法读取到凭证、桶名、Region等关键配置，进而引发凭证加载失败。
2. 冗余配置干扰：Heroku中配置的AWS_ROLE_ARN、AWS_PROFILE属于多余配置，代码明确使用静态凭证模式，这些配置会触发AWS SDK尝试加载实例元数据或本地配置文件，导致连接拒绝错误。
3. Region配置缺失：Heroku中未配置S3所在Region，代码中spring.cloud.aws.region.static无对应值，导致S3客户端初始化失败。

解决方案 #

1. 修正Heroku配置变量 #

更新Heroku环境变量，使其与代码中的Spring配置属性一一对应：

2. 验证配置加载（可选） #

在S3Config中添加日志，确认配置是否正确加载，方便排查：

@Configuration
public class S3Config {
    @Value("${spring.cloud.aws.credentials.accessKey}")
    private String accessKey;
    @Value("${spring.cloud.aws.credentials.secretKey}")
    private String secretKey;
    @Value("${spring.cloud.aws.region.static}")
    private String region;

    private static final Logger logger = LoggerFactory.getLogger(S3Config.class);

    @Bean
    public AmazonS3 amazonS3Client() {
        // 仅打印凭证后四位，避免泄露敏感信息
        logger.info("Loaded AWS access key suffix: {}", accessKey != null ? accessKey.substring(accessKey.length()-4) : "null");
        logger.info("Loaded AWS region: {}", region);
        
        AWSCredentialsProvider credentialsProvider = new AWSStaticCredentialsProvider(
                new BasicAWSCredentials(accessKey, secretKey)
        );
        return AmazonS3ClientBuilder.standard()
                .withRegion(region)
                .withCredentials(credentialsProvider)
                .build();
    }
}

3. 重启Heroku应用 #

修改配置后，重启应用使新配置生效：

heroku restart --app wili-be-ae9b2e96541b

补充说明 #

Spring Boot支持自动将大写下划线格式的环境变量转换为驼峰命名的配置属性，例如SPRING_CLOUD_AWS_CREDENTIALS_ACCESS_KEY会自动映射到spring.cloud.aws.credentials.accessKey，确保配置能被正确读取。

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