使用Boto3创建S3 Bucket时遇IllegalLocationConstraintException异常求助

核心问题：区域配置不匹配 #

S3的桶创建规则对区域有严格要求，尤其是us-east-1（默认区域）和其他区域的处理逻辑不同，你的错误本质是客户端指定的区域与桶创建时的位置约束不匹配，或者区域与请求发送的端点不对应。

针对性解决方案 #

1. 创建us-east-1区域的桶（无需位置约束）

us-east-1是S3的默认区域，创建时不需要额外指定CreateBucketConfiguration参数，确保客户端的region_name明确设为us-east-1即可：

import boto3

s3_client = boto3.client('s3',
                         aws_access_key_id=api_id,
                         aws_secret_access_key=apikey,
                         region_name='us-east-1')

bucket_name = 'test1'
s3_client.create_bucket(Bucket=bucket_name)

2. 创建其他区域的桶（必须匹配区域与约束）

如果要创建非us-east-1区域的桶（比如us-east-2），必须同时满足两个条件：

• 客户端的region_name设置为目标区域
• CreateBucketConfiguration中的LocationConstraint与region_name完全一致

示例代码：

import boto3

s3_client = boto3.client('s3',
                         aws_access_key_id=api_id,
                         aws_secret_access_key=apikey,
                         region_name='us-east-2')

bucket_name = 'test1'
s3_client.create_bucket(
    Bucket=bucket_name,
    CreateBucketConfiguration={'LocationConstraint': 'us-east-2'}
)

额外排查点 #

• 检查是否手动指定了endpoint_url参数：如果代码中额外设置了错误的端点地址，会导致区域不匹配，建议移除该参数，让boto3自动匹配对应区域的端点。
• 确认AWS配置优先级：boto3的配置优先级为代码参数 > 环境变量 > .aws/config文件，如果代码中指定了region_name，会覆盖配置文件的设置，确保两者一致。
• 验证桶名称唯一性：虽然你的错误提示是区域问题，但如果桶名称已被其他账户占用，也可能触发异常（不过错误信息会不同），可以尝试更换桶名称测试。

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