使用DigitalOcean Spaces调用ListObjects时出现NoSuchKey错误求助

针对你使用aioboto3调用DigitalOcean Spaces时，能正常上传文件但调用list_objects报NoSuchKey错误的问题，以下是具体原因分析及解决办法：

1. 旧版list_objects API兼容性问题 #

DigitalOcean Spaces对S3旧版list_objects API的兼容性存在异常，该接口在部分场景下会被错误解析为"获取对象"请求，而非"列出桶内文件"，从而触发NoSuchKey错误。

解决办法：
将代码中的list_objects替换为新版的list_objects_v2接口：

response = await s3_client.list_objects_v2(Bucket=bucket_name)

返回逻辑无需修改，list_objects_v2的返回结构与旧接口一致，仍可通过response.get("Contents", [])获取文件列表。

2. Endpoint URL格式错误 #

如果你的endpoint_url配置为包含桶名的格式（如https://mybucket.nyc3.digitaloceanspaces.com），此时再传递Bucket参数会导致请求被错误解析为获取名为mybucketname的对象，而非列出桶内文件，进而触发NoSuchKey错误。

解决办法：
将endpoint_url改为区域通用地址，例如纽约3区域的地址为https://nyc3.digitaloceanspaces.com，确保桶名仅通过Bucket参数传递，不要包含在endpoint中。

3. IAM权限缺失（低概率但需排查） #

虽然你的凭证拥有上传权限（s3:PutObject），但可能缺少列出桶内对象的权限（s3:ListBucket）。DigitalOcean Spaces的IAM策略需要明确授予该权限才能执行列表操作。

解决办法：
登录DigitalOcean控制面板，检查对应凭证的IAM策略，确保包含针对目标桶的s3:ListBucket权限。示例策略如下：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::your-bucket-name",
        "arn:aws:s3:::your-bucket-name/*"
      ]
    }
  ]
}

其中arn:aws:s3:::your-bucket-name对应桶本身的权限（用于列表操作），arn:aws:s3:::your-bucket-name/*对应桶内对象的操作权限。

4. 额外验证步骤 #

• 确认存储桶内确实存在文件：通过DigitalOcean控制面板直接查看目标桶，避免上传时因路径错误导致文件未存入预期桶中。
• 核对region_name配置：确保与存储桶创建时选择的区域完全一致，虽然上传正常时该概率较低，但区域不匹配可能导致列表请求异常。

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