使用node s3-cli访问含点S3 Bucket出现端点错误的解决咨询

这种错误我之前帮不少开发者排查过，本质是你的目标S3存储桶sudomain.domain.com的区域配置，和s3-cli默认使用的全局endpoint不匹配导致的。AWS对于部分区域（尤其是非us-east-1）或者域名格式的桶名，强制要求使用对应区域的专属endpoint来访问，否则就会抛出这个提示。

下面是具体的解决步骤：

1. 确认目标桶的所在区域 #

首先你需要明确这个桶创建在哪个AWS区域：

• 最简单的方式是登录AWS控制台，找到S3服务，定位到sudomain.domain.com桶，查看它的属性页里的“区域”信息；
• 如果你本地装了AWS CLI，也可以直接执行命令查询：

aws s3api get-bucket-location --bucket sudomain.domain.com

返回的结果会告诉你具体区域（比如ap-northeast-1、eu-west-1等）。

2. 在同步命令中指定对应区域的Endpoint #

拿到区域信息后，在s3-cli命令里加上--endpoint-url参数即可，比如你的桶在ap-southeast-1区域，命令就改成：

s3-cli sync --delete-removed dist s3://sudomain.domain.com --endpoint-url https://s3.ap-southeast-1.amazonaws.com

注意替换成你实际查到的区域对应的endpoint格式，一般都是https://s3.${区域名}.amazonaws.com。

3. （可选）配置s3-cli的profile避免重复加参数 #

如果这个桶是你经常要同步的，可以把区域配置写到s3-cli的配置文件里，省得每次都手动加参数：

• 打开（或创建）~/.s3cfg文件，添加一个新的profile：

[profile sudomain-bucket]
bucket_location = ap-southeast-1
endpoint_url = https://s3.ap-southeast-1.amazonaws.com

• 之后同步时直接指定profile即可：

s3-cli --profile sudomain-bucket sync --delete-removed dist s3://sudomain.domain.com

补充说明 #

你之前的domain-admin-dev桶能正常同步，大概率是因为它创建在us-east-1区域（AWS最早的区域），或者桶名不是标准域名格式，AWS允许这类桶使用全局endpoint访问；而新桶sudomain.domain.com不符合这个宽松条件，所以必须严格匹配区域endpoint。

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