通过Docker Compose部署LocalStack，Golang操作S3提示Bucket不存在求助

1. 确认LocalStack服务状态与配置 #

• 检查Docker Compose配置，必须确保S3服务已启用，同时指定默认区域（LocalStack的S3对区域要求严格，默认用us-east-1最稳妥）。参考配置片段：

services:
  localstack:
    image: localstack/localstack:latest
    ports:
      - "4566:4566"
    environment:
      - SERVICES=s3
      - DEFAULT_REGION=us-east-1
      - DEBUG=1

• 启动后别着急执行命令，等服务完全就绪。可以用这个命令检查状态：curl http://localhost:4566/health，直到输出里S3的状态显示为running。

2. 给AWS CLI命令添加区域参数 #

LocalStack的S3不接受无区域的请求，哪怕创建时没报错，后续查询也会因区域不匹配找不到桶。执行创建命令时必须带上--region参数：

aws --endpoint-url=http://localhost:4566 s3api create-bucket --bucket tags --region us-east-1

如果你的LocalStack配置了其他区域（比如eu-west-1），命令里的区域也要对应改成一致的。

3. 用正确命令验证桶是否存在 #

创建后等几秒再检查，LocalStack偶尔会有同步延迟。推荐用以下两种方式验证：

• 检查单个桶：aws --endpoint-url=http://localhost:4566 s3api head-bucket --bucket tags --region us-east-1（返回空表示桶存在，报错才是不存在）
• 列出所有桶：aws --endpoint-url=http://localhost:4566 s3 ls --region us-east-1
  避免使用s3 ls s3://tags这类方式，很容易因区域问题误报“不存在”。

4. 排查网络连通性 #

• 如果在主机上执行AWS CLI，先确认4566端口能通：telnet localhost 4566或者curl http://localhost:4566，不通的话检查Docker端口映射是否正确。
• 如果在其他容器里执行命令，要确保容器和LocalStack在同一个Docker网络中，此时端点需改为容器名：http://localstack:4566。

5. 通过LocalStack日志定位问题 #

开启DEBUG模式后，查看LocalStack日志能直接看到请求细节，比如创建桶时的区域是否正确、是否有报错：

docker-compose logs localstack

日志会记录S3的所有操作，能快速定位是请求参数问题还是服务本身的问题。

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