Spring Boot连接AWS S3时抛出IllegalArgumentException: Access key cannot be null

问题根源 #

你的代码抛出IllegalArgumentException: Access key cannot be null的核心原因是：Spring的@Value注解无法直接注入静态字段。你在Constants类中将配置项定义为静态变量，Spring不会为静态字段注入配置值，导致Constants.ACCESS_KEY、Constants.SECRET等变量始终为null，创建BasicAWSCredentials时自然触发异常。

解决方案 #

以下是几种可行的修复方式，按推荐程度排序：

方案1：将Constants改为Spring管理的Bean（推荐）

把Constants类改为非静态字段，通过@Component让Spring扫描管理，再在S3Config中注入使用：

修改后的Constants类：

@Component
public class Constants {

    @Value("${accessKey}")
    public String ACCESS_KEY;

    @Value("${secret}")
    public String SECRET;

    @Value("${region}")
    public String REGION;

    @Value("${bucket}")
    public String BUCKET;

}

修改后的S3Config类：

@Configuration
public class S3Config {

    private final Constants constants;

    // Spring 4.3+支持无@Autowired的构造注入
    public S3Config(Constants constants) {
        this.constants = constants;
    }

    @Bean
    public AmazonS3 s3() {
        AWSCredentials awsCredentials = new BasicAWSCredentials(constants.ACCESS_KEY, constants.SECRET);

        return AmazonS3ClientBuilder
                .standard()
                .withRegion(constants.REGION)
                .withCredentials(new AWSStaticCredentialsProvider(awsCredentials))
                .build();
    }

}

方案2：直接在S3Config中注入配置项

如果不需要单独的Constants类，可直接在配置类里用@Value注入所需配置值：

@Configuration
public class S3Config {

    @Value("${accessKey}")
    private String accessKey;

    @Value("${secret}")
    private String secret;

    @Value("${region}")
    private String region;

    @Bean
    public AmazonS3 s3() {
        AWSCredentials awsCredentials = new BasicAWSCredentials(accessKey, secret);

        return AmazonS3ClientBuilder
                .standard()
                .withRegion(region)
                .withCredentials(new AWSStaticCredentialsProvider(awsCredentials))
                .build();
    }

}

方案3：通过Setter方法注入静态字段（不推荐）

如果必须保留静态变量，可通过实例Setter方法赋值，同时让Spring扫描Constants类：

@Component
public class Constants {

    public static String ACCESS_KEY;
    public static String SECRET;
    public static String REGION;
    public static String BUCKET;

    @Value("${accessKey}")
    public void setAccessKey(String accessKey) {
        ACCESS_KEY = accessKey;
    }

    @Value("${secret}")
    public void setSecret(String secret) {
        SECRET = secret;
    }

    @Value("${region}")
    public void setRegion(String region) {
        REGION = region;
    }

    @Value("${bucket}")
    public void setBucket(String bucket) {
        BUCKET = bucket;
    }
}

这种方式虽能解决问题，但静态变量会破坏Spring依赖注入原则，不利于测试和维护，不推荐使用。

内容的提问来源于stack exchange，提问作者dev.darron