Spring Boot使用S3Client连接Scaleway存储时配置文件解析报错

问题根源 #

AWS SDK v2默认会自动扫描本地的AWS配置文件（~/.aws/credentials 或 ~/.aws/config）——哪怕你已经在代码里硬编码了accessKey、secretKey这些参数。如果这些本地配置文件存在格式错误（比如报错提示的第12行缺少=号），就会触发这个解析失败的错误。

具体解决办法 #

1. 修复本地配置文件格式 #

直接打开报错提示的对应文件（比如~/.aws/config或~/.aws/credentials），找到第12行：

• 确保每一行都是键=值的格式，比如：

  aws_access_key_id=你的Scaleway访问密钥
  aws_secret_access_key=你的Scaleway秘密密钥
  region=fr-par
  

• 删掉空行，或者修正注释（注释必须以#开头）

2. 强制SDK不加载本地配置文件 #

如果不需要本地配置文件，直接在构建S3Client时禁用自动加载逻辑，代码示例：

import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.S3Configuration;
import java.net.URI;

public class ScalewayStorageService {
    private final S3Client s3Client;

    public ScalewayStorageService() {
        // 硬编码Scaleway密钥
        AwsBasicCredentials credentials = AwsBasicCredentials.create("你的ACCESS_KEY", "你的SECRET_KEY");
        
        s3Client = S3Client.builder()
                .credentialsProvider(StaticCredentialsProvider.create(credentials))
                .endpointOverride(URI.create("https://s3.fr-par.scw.cloud")) // 替换成你的Scaleway区域endpoint
                .region(Region.of("fr-par")) // 替换成你的Scaleway区域，比如nl-ams、pl-waw
                // 禁用自动加载本地配置文件，同时开启Scaleway需要的路径样式访问
                .overrideConfiguration(builder -> builder
                        .disableAutomaticRegionDetection()
                        .putAdvancedOption(S3Configuration.ADVANCED_S3_OPTION_PATH_STYLE_ACCESS, true))
                .build();
    }

    // 你的上传下载方法...
}

划重点：Scaleway S3必须开启路径样式访问，上面的配置已经包含这一项，这是兼容Scaleway存储的关键。

3. 用环境变量绕开本地文件 #

不想改代码或本地文件的话，可以设置环境变量AWS_CONFIG_FILE指向一个空文件，或者直接设置AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY环境变量——SDK会优先读取环境变量，跳过本地配置文件的加载。

验证 #

重启应用后调用下载接口，看看是否还出现配置文件解析错误。如果问题消失，说明要么是配置文件格式修好了，要么是自动加载逻辑被成功禁用了。

内容的提问来源于stack exchange，提问作者Benjamin Barbé