S3 PutObject 超时主因是 region 与 bucket region 不一致导致跨域路由；大文件上传应设 ContentLength 或改用 s3manager.Uploader；GetObject NotFound 常因 key 编码或前导/问题；容器中需用 LoadDefaultConfig 启用自动凭据链。aws-sdk-go-v2 的 s3.PutObject 为什么一直超时？不是网络问题，大概率是没配对 region 和 endpoint。AWS S3 要求客户端 region 必须和 bucket 所在 region 严格一致，否则 SDK 会默默走默认 global endpoint（s3.amazonaws.com），触发跨 region 路由，延迟飙升甚至超时。检查 bucket region：用 aws s3api get-bucket-location --bucket your-bucket-name 确认真实 region（注意：us-east-1 返回空字符串，得按逻辑视为 us-east-1）初始化 client 时显式传 region，别依赖 config 文件或环境变量自动推断国内用户若用 AWS CN 区域（如 cn-north-1），必须配 endpoint 为 https://s3.cn-north-1.amazonaws.com.cn，且 region 必须设成 cn-north-1上传大文件时内存暴涨，s3.PutObject 能否流式处理？不能直接流式，s3.PutObject 要求一次性提供 body（io.Reader），但 SDK 内部仍会尝试读取全部内容做 checksum 和签名——尤其当 body 是 *os.File 或未设 ContentLength 时，SDK 会先 stat 或全读一遍来算长度，导致大文件卡住或 OOM。上传 >5MB 的文件，优先改用 s3.NewPresignClient 生成预签名 URL，让前端直传，或后端用 s3manager.Uploader若坚持用 PutObject，务必提前设置 ContentLength 字段（比如 stat.Size()），并确保 body 支持 Seek（*os.File 可以，bytes.Reader 不行）s3manager.Uploader 自动分片、并发上传、重试，对 >100MB 文件更稳，但需额外初始化 s3manager.NewUploader 实例下载文件时 s3.GetObject 返回 NotFound，但控制台能看见对象常见于 key 名含特殊字符（空格、中文、+、%）或路径开头带 /。S3 key 是纯字符串，不按“目录”解析，但 SDK 默认会对 key 做 URL 编码，而控制台显示的是解码后的结果，容易误判。用 aws s3api head-object --bucket your-bucket --key "your-key" 直接验证 key 是否存在（绕过 SDK 编码逻辑）检查代码中拼接的 key 变量是否有多余的前导 /（比如 "/path/to/file.txt" → 应为 "path/to/file.txt"）避免手动拼接 key，用 path.Join 后再 trim 开头的 /；若 key 来自用户输入，先 url.PathEscape 再传给 SDKGo 程序部署到 ECS 或 EKS 时，credentials 总是加载失败不是权限没开，而是 SDK 默认只查 ~/.aws/credentials 和环境变量，而容器里既没 home 目录也没 AWS_PROFILE，它根本不会去拉 EC2 Instance Role 或 EKS IRSA 的 token。 唱鸭 音乐创作全流程的AI自动作曲工具，集 AI 辅助作词、AI 自动作曲、编曲、混音于一体