Spring Boot集成AWS S3报错：指定存储桶不存在（实际已存在）

以下是针对该问题的具体排查方向和解决方法：

• 检查S3客户端的区域配置
  S3存储桶是区域绑定的，若客户端初始化时指定的区域与桶实际所在区域不匹配，请求会被路由到错误的端点，直接触发404。务必确认配置类中Region参数和AWS控制台里桶的区域完全一致，比如桶在ap-southeast-1，就不能写成ap-southeast-2。
  修正示例：

  @Bean
  public S3Client s3Client() {
      return S3Client.builder()
              .region(Region.AP_SOUTHEAST_1) // 和桶的实际区域严格一致
              .credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create(accessKey, secretKey)))
              .build();
  }
  

• 验证桶名的准确性
  虽然S3桶名不区分大小写，但部分区域的端点对桶名的大小写匹配有严格要求，同时要避免桶名包含下划线等不符合DNS规则的字符（虚拟主机寻址模式下）。检查代码中使用的桶名字符串，确保和控制台中的完全一致，没有多余空格或拼写错误。

• 排查IAM用户权限（隐性404场景）
  S3有时会用404错误掩盖权限不足的问题，而非返回403。即使你配置了AccessKey和Secret，若IAM用户没有s3:PutObject或s3:ListBucket权限，也会导致无法识别桶的存在。给IAM用户添加以下权限策略：

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": "s3:PutObject",
              "Resource": "arn:aws:s3:::你的桶名/*"
          },
          {
              "Effect": "Allow",
              "Action": "s3:ListBucket",
              "Resource": "arn:aws:s3:::你的桶名"
          }
      ]
  }
  

• 切换到路径寻址模式
  若桶名包含点号或不符合DNS规则，虚拟主机寻址（https://桶名.s3.区域.amazonaws.com）会出现解析问题。可以强制客户端使用路径寻址：

  @Bean
  public S3Client s3Client() {
      return S3Client.builder()
              .region(Region.AP_SOUTHEAST_1)
              .credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create(accessKey, secretKey)))
              .serviceConfiguration(config -> config.pathStyleAccessEnabled(true)) // 启用路径寻址
              .build();
  }
  

• 测试网络连通性
  若应用部署在有代理或网络受限的环境中，可能无法正常访问S3端点。用curl命令测试本地能否访问桶的端点：

  curl -i https://s3.你的区域.amazonaws.com/你的桶名
  

  若返回403，说明桶存在但权限不足；若返回404，大概率是网络无法到达该S3端点。

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