使用Boto3调用OVH S3 API时遇“指定存储桶无效”错误求助

问题概述 #

尝试通过OVH对象存储的S3 API实现GetObject请求，此前Python项目有相同实现，但当前报错：

The specified bucket is not valid.

已确认存储桶名称准确、权限无误，相同环境变量在JavaScript项目中可正常使用，修改密钥后错误提示未变，推测可能是格式或配置问题。

原代码（存在明显错误） #

import boto3

client = boto3.client(
    's3',
    aws_access_key_id=ACCESS_KEY,
    aws_secret_access_key=SECRET_KEY,
    aws_endpoint_url=ENDPOINT_URL,  # 参数名错误
    region_name=REGION_NAME
)

s3_response_object = s3_client.get_object(Bucket=BUCK_NAME_IS_STRING, Key='KEY_STRING')  # 变量名不匹配

print(s3_response_object)

排查与修复方案 #

1. 修正代码基础错误 #

• 变量名不一致：初始化的客户端变量是client，调用时却用了s3_client，直接导致变量未定义；
• 参数名错误：boto3中指定端点的参数是endpoint_url，而非aws_endpoint_url。

2. 适配OVH S3兼容配置 #

OVH对象存储对S3 API的兼容有特定要求，需补充签名版本配置：

import boto3

s3_client = boto3.client(
    's3',
    aws_access_key_id=ACCESS_KEY,
    aws_secret_access_key=SECRET_KEY,
    endpoint_url=ENDPOINT_URL,
    region_name=REGION_NAME,
    config=boto3.session.Config(signature_version='s3v4')  # 显式指定S3v4签名
)

s3_response_object = s3_client.get_object(Bucket=BUCK_NAME_IS_STRING, Key='KEY_STRING')
print(s3_response_object)

3. 验证桶名与区域匹配 #

• 桶名格式：OVH S3兼容模式要求桶名符合S3标准规则：仅含小写字母、数字、连字符，不能以连字符开头/结尾，长度3-63字符；
• 区域与端点匹配：确保REGION_NAME和ENDPOINT_URL与桶所在OVH地域严格对应，不匹配会触发桶无效错误。

4. 额外排查点 #

如果上述修复后仍报错，可尝试：

• 打印完整请求日志，查看实际发送的桶名和端点是否正确；
• 用head_bucket接口先验证桶的可访问性，缩小问题范围。

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