S3 Bucket下载失败求助：无法找到Bucket或指定Key

核心问题分析 #

你遇到的情况是本地S3兼容服务（比如LocalStack）的访问路径风格与AWS SDK默认配置不匹配，加上错误地给Bucket名加斜杠导致Key解析异常。

具体解决方案 #

1. 修正SDK配置，启用路径式访问 #

本地S3服务大多默认使用路径式访问（即请求URL为http://localhost:4566/testBucket/test.json），而AWS SDK默认用虚拟主机式访问。只需在会话配置中添加S3ForcePathStyle参数即可：

// 1) Define your bucket and item names
bucket := "testBucket" 
item := "test.json"

sess, err := session.NewSession(&aws.Config{
    Endpoint:         aws.String("http://localhost:4566"),
    Region:           aws.String("us-west-2"),
    S3ForcePathStyle: aws.Bool(true), // 关键：强制使用路径式访问
})
if err != nil {
    log.Fatalf("Failed to create session: %v", err)
}

downloader := s3manager.NewDownloader(sess)

file, err := os.Create(item)
if err != nil {
    log.Fatalf("Failed to create local file: %v", err)
}
defer file.Close() // 务必关闭文件句柄

numBytes, err := downloader.Download(file,
    &s3.GetObjectInput{
        Bucket: aws.String(bucket), // Bucket名不要加任何斜杠
        Key:    aws.String(item),   // Key直接用文件名，无需前缀
    })

if err != nil {
    log.Fatalf("Unable to download item %q, %v", item, err)
}

log.Printf("Successfully downloaded %d bytes from %s/%s", numBytes, bucket, item)

2. 排查Bucket和Key的实际状态 #

用AWS CLI（适配本地服务）确认资源是否存在，避免大小写或拼写错误：

# 列出所有Bucket
aws --endpoint-url=http://localhost:4566 s3 ls

# 列出目标Bucket内的所有文件
aws --endpoint-url=http://localhost:4566 s3 ls s3://testBucket/

注意：S3的Key是区分大小写的，确保代码中的test.json和实际存储的文件名完全一致。

3. 校验Region一致性 #

本地S3服务通常对Region匹配有严格要求：

• 如果创建Bucket时未指定Region，尝试把代码中的Region改成us-east-1（多数本地服务默认值）；
• 确保创建Bucket和下载文件时使用的Region完全相同。

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