AWS SDK for Java v2在EC2实例中无法加载~/.aws/credentials凭证的问题及默认凭证链机制确认

核心结论：默认凭证提供者链确实自动完成凭证查找 #

先给你明确的答案：是的，AWS SDK for Java v2的DefaultCredentialsProvider（也就是你异常里提到的AwsCredentialsProviderChain）确实会按照文档描述的顺序自动查找凭证，初始化服务客户端时完全不需要手动指定凭证提供者——只要你不特意传自定义的凭证提供者，SDK就会自动按顺序尝试从环境变量、Java系统属性、Web身份令牌、默认配置文件、ECS容器凭证、EC2实例配置文件这几个源加载凭证。

为什么你的Java应用读不到~/.aws/credentials？ #

从你抛出的异常信息里，关键错误是这句：

ProfileCredentialsProvider(): Profile file contained no credentials for profile 'default': ProfileFile(profiles=[])

这说明SDK的ProfileCredentialsProvider模块没有找到有效的默认配置文件，大概率是以下几个原因：

• Java进程的运行用户和配置凭证的用户不是同一个：你用AWS CLI执行命令的用户（比如ec2-user）和运行Java应用的用户（比如root、tomcat或者其他服务用户）不一致，而~/.aws/credentials里的~是当前用户的家目录，不同用户的家目录完全不同，Java进程自然读不到你配置的凭证文件。
• 凭证文件的权限不符合安全要求：AWS要求~/.aws/credentials和~/.aws/config的权限必须是600（仅所有者可读可写），如果权限设置得太宽松（比如644），SDK会出于安全考虑直接忽略这个文件。
• Java进程的HOME环境变量异常：有些场景下，Java进程启动时没有正确加载HOME环境变量，导致SDK无法定位到~/.aws/credentials的路径。

解决步骤 #

按以下顺序排查和修复：

1. 确认Java进程的运行用户
   先找出Java应用是用哪个用户运行的：

   ps aux | grep java
   

   切换到该用户，检查它的家目录下有没有.aws/credentials文件：

   su - <java-process-user>
   cat ~/.aws/credentials
   

   如果没有，就把你已经配置好的credentials文件复制到该用户的.aws目录下，或者创建软链接。
2. 修复凭证文件的权限
   对目标用户的.aws目录和credentials文件设置正确的权限：

   chmod 700 ~/.aws
   chmod 600 ~/.aws/credentials
   

3. 确保Java进程能获取正确的HOME环境变量
   如果是通过脚本启动Java应用，可以在脚本里显式指定HOME变量：

   export HOME=/home/<java-process-user>
   java -jar your-application.jar
   

4. 可选：显式指定凭证文件路径（临时 workaround）
   如果前面的方法都无效，可以在代码里显式指定凭证文件的路径，绕过默认的路径查找逻辑：

   import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
   import software.amazon.awssdk.profiles.ProfileFile;
   import java.nio.file.Paths;
   import software.amazon.awssdk.services.s3.S3Client;
   
   public class S3Uploader {
       public static void main(String[] args) {
           ProfileCredentialsProvider credentialsProvider = ProfileCredentialsProvider.builder()
                   .profileFile(ProfileFile.builder()
                           .type(ProfileFile.Type.CREDENTIALS)
                           .path(Paths.get("/home/ec2-user/.aws/credentials")) // 替换为你的凭证文件路径
                           .build())
                   .build();
   
           try (S3Client s3Client = S3Client.builder()
                   .credentialsProvider(credentialsProvider)
                   .build()) {
               // 你的S3上传逻辑
           }
       }
   }
   

   不过这只是临时方案，优先解决用户一致性和权限问题更符合AWS的最佳实践。

补充验证 #

修复后，可以在Java应用里加一段调试代码，确认当前用户的家目录和环境变量是否正确：

System.out.println("Current user home directory: " + System.getProperty("user.home"));
System.out.println("HOME environment variable: " + System.getenv("HOME"));

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