如何使用AWS Java SDK加载~/.aws/config配置文件？

阿华AIGC实验室

2026-5-19

Java AWS SDK 没有 AWS_SDK_LOAD_CONFIG 等效变量的说明

我之前也折腾过不同语言AWS SDK的配置加载逻辑，完全懂你现在的困惑！确实像你查到的那样，JavaScript和Go SDK可以通过设置AWS_SDK_LOAD_CONFIG环境变量为真值（比如true或1）来触发加载额外的配置文件，但Java SDK的设计思路完全不一样，这里给你理清楚相关情况：

你的推测完全正确：Java SDK不支持AWS_SDK_LOAD_CONFIG变量
我自己测试过，也翻了Java SDK（v1和v2）的源码，这个环境变量在Java SDK的配置加载流程里根本没被引用过。Java SDK有一套自己独立的配置加载优先级和触发机制，不会识别这个来自其他语言SDK的变量。
Java SDK的默认配置加载逻辑
Java SDK不管是v1还是v2，都会按固定优先级加载配置，顺序大概是：
1. 代码里显式设置的配置（比如通过AwsClientBuilder直接指定的凭证、区域）
2. 系统环境变量（像AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION这些）
3. JVM系统属性（比如aws.accessKeyId、aws.secretKey）
4. ~/.aws/credentials凭证文件
5. ~/.aws/config配置文件（注意：v1需要显式用ProfileCredentialsProvider来加载这个文件，v2则默认会自动读取）

如果要实现类似AWS_SDK_LOAD_CONFIG的触发逻辑
要是你想通过环境变量来控制是否加载配置文件，可以自己写个简单的工具类来实现，比如：

import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;

public class AwsClientHelper {
    public static S3Client getS3Client() {
        String shouldLoadConfig = System.getenv("CUSTOM_AWS_LOAD_CONFIG");
        if ("true".equalsIgnoreCase(shouldLoadConfig)) {
            // 显式依赖配置文件加载
            return S3Client.builder()
                    .credentialsProvider(DefaultCredentialsProvider.create())
                    .region(Region.of(System.getenv("AWS_REGION")))
                    .build();
        } else {
            // 使用默认优先级加载，不强制依赖配置文件
            return S3Client.create();
        }
    }
}

这里用自定义的CUSTOM_AWS_LOAD_CONFIG环境变量来控制，模拟类似JS/Go SDK的触发效果。