LocalStack启动S3兼容服务时，endpoint必须配为http://localhost:4566，并通过config.WithEndpointResolverWithOptions强制指定且o.ResolveUnknownService=true，同时保留config.WithRegion("us-east-1")和静态凭证。
用 LocalStack 启动 S3 兼容服务时 endpoint 怎么配才不报错
LocalStack 的 S3 服务默认监听 http://localhost:4566，但 Go SDK（尤其是 aws-sdk-go-v2）会默认尝试用 region 做 DNS 解析，比如填 us-east-1 就去找 s3.us-east-1.amazonaws.com —— 这在 LocalStack 下必然失败。
必须显式绕过默认解析逻辑：
-
config.WithEndpointResolverWithOptions强制返回http://localhost:4566，且o.ResolveUnknownService = true否则 SDK 会拒绝识别非 AWS 官方 service 名 -
config.WithRegion("us-east-1")仍需保留，因为签名过程依赖 region 字符串构造 header，哪怕它不参与 DNS - 不要设
credentials为 nil：LocalStack 默认接受任意 AK/SK，但 SDK 要求非空，可用credentials.NewStaticCredentialsProvider("test", "test", "")
GoLand 调试时如何让 dlv 连上 LocalStack 并命中断点
关键不是“连上 LocalStack”，而是让 Go 程序运行时能访问到 LocalStack，同时调试器能 attach 到进程。常见卡点是环境变量没透传或端口被占用。
在 GoLand 的 Run → Edit Configurations 中设置：
- Working directory 设为项目根目录（确保
docker-compose.yml可被正确读取） - Environment variables 加入：
AWS_ENDPOINT_URL=http://localhost:4566、AWS_REGION=us-east-1、AWS_ACCESS_KEY_ID=test、AWS_SECRET_ACCESS_KEY=test - Program arguments 留空，避免误触发 Lambda 模式分支（如果你代码里有
os.Getenv("AWS_LAMBDA_FUNCTION_NAME")判断） - 勾选 “Allow multiple instances” —— 否则第二次 debug 会提示 port already in use
用 aws-sdk-go-v2/service/s3 调阿里云 OSS 时为什么总 403
不是权限问题，大概率是签名参数错位。OSS 不认 oss 签名方式，强制要求 signingName: "s3"，否则 SDK 会拼出 X-Amz-Signature 以外的 header，OSS 直接拒收。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
配置必须满足三要素：
-
endpoint是纯服务地址，如https://oss-cn-hangzhou.aliyuncs.com（不能带 bucket、不能是 HTTP） -
config.WithEndpointResolverWithOptions必须指定，且service参数传"s3"，不能依赖 region 映射 -
config.WithRegion("oss-cn-hangzhou")的值必须和 endpoint 中的 region 完全一致，大小写、中横线都不能错
漏掉任一条件，s3Client.PutObject 就会返回 403 Forbidden，且错误信息里不提示具体原因。
调试中上传文件卡住不动，怎么快速定位是超时还是 DNS 问题
先看日志输出有没有 context deadline exceeded —— 有就是超时；没有就大概率是 DNS 或连接阻塞。S3 兼容服务对超时极其敏感，尤其本地调试时网络路径长。
两个最简验证动作：
- 终端执行
curl -v http://localhost:4566/health（LocalStack）或curl -v https://oss-cn-hangzhou.aliyuncs.com（OSS），确认基础连通性 - 在 Go 代码里给
s3.NewFromConfig加config.WithHTTPClient(&http.Client{Timeout: 10 * time.Second})，避免默认无 timeout 导致 goroutine 挂起 - 如果用的是
bucket.PutObjectFromFile类封装方法（如阿里云 SDK），必须显式传oss.Timeout(30000)，它的默认值是 0（无限等待）
本地调试最常被忽略的是 HTTP client timeout 和 endpoint 协议头缺失，这两处一错，现象都是“没报错、也不返回”，实际是卡在 connect 阶段。
