AWS S3 SYNC下载含空格对象报NoSuchKey错误如何处理？

你遇到的报错本质是AWS CLI默认的URL编码处理逻辑和你使用的对象存储服务（你使用了自定义endpoint，非AWS官方S3）的返回编码不匹配：
报错信息中的test+285.json实际对应存储桶内键为test 285.json（中间为空格）的对象，CLI未开启编码解析时会将+识别为字面量加号，用错误的键名发起GetObject请求，最终触发NoSuchKey错误。

方案1：添加编码类型参数（优先推荐） #

在原有同步命令中添加--encoding-type url参数，告知CLI服务端返回的对象键是URL编码格式，CLI会自动完成编码和解码，兼容带空格的对象键：

aws s3 sync s3://bucket . --endpoint-url <ENDPOINT> --no-verify-ssl --profile test --encoding-type url

90%以上的第三方兼容S3的对象存储（比如MinIO、阿里云OSS、腾讯云COS等）都支持该参数，无需修改存储桶内的对象即可正常同步。

方案2：批量替换存储桶内对象键的空格 #

如果使用的对象存储不支持--encoding-type参数，可以批量将对象键中的空格替换为下划线或%20后再同步：

Linux/macOS 环境批量修改命令： #

# 先列出所有带空格的对象确认
aws s3 ls s3://bucket --recursive --endpoint-url <ENDPOINT> --profile test | grep " " | awk '{print substr($0,index($0,$4))}'

# 批量将空格替换为下划线
for key in $(aws s3 ls s3://bucket --recursive --endpoint-url <ENDPOINT> --profile test | grep " " | awk '{print substr($0,index($0,$4))}'); do newkey=$(echo $key | tr ' ' '_'); aws s3 mv "s3://bucket/$key" "s3://bucket/$newkey" --endpoint-url <ENDPOINT> --profile test; done

Windows PowerShell 环境批量修改命令： #

# 批量替换空格为下划线
Get-ChildItem -File | ForEach-Object {
  $oldKey = $_.Name
  $newKey = $oldKey -replace ' ', '_'
  aws s3 mv "s3://bucket/$oldKey" "s3://bucket/$newKey" --endpoint-url <ENDPOINT> --profile test
}

方案3：分批次同步 #

如果不想修改存储桶内的对象，也可以分两次同步，先同步所有不带空格的对象，再单独同步带空格的对象：

# 同步所有不带空格的对象
aws s3 sync s3://bucket . --endpoint-url <ENDPOINT> --no-verify-ssl --profile test --exclude "* *"

# 单独同步带空格的对象
aws s3 sync s3://bucket . --endpoint-url <ENDPOINT> --no-verify-ssl --profile test --include "* *" --exclude "*" --encoding-type url

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