直接使用aliyun/aliyun-oss-go-sdk/oss SDK，避免手拼HTTP请求；初始化client常见panic或403因endpoint格式错误（须为https://oss-cn-hangzhou.aliyuncs.com）、凭据未走正确链路（须用RAM子账号+环境变量OSS_ACCESS_KEY_ID/SECRET或ECS角色）。
直接用 `aliyun/aliyun-oss-go-sdk/oss`，别自己拼 HTTP 请求——签名、超时、分片、断点续传全得自己兜底，容易出错。
初始化 client 为什么总 panic 或 403？
常见原因是 endpoint 格式不对，或凭据没走对链路：
• oss.New() 的第一个参数必须是带 https:// 的完整 Region Endpoint（如 "https://oss-cn-hangzhou.aliyuncs.com"），不能只写域名，也不能带 bucket 名或路径；
• AccessKey ID/Secret 必须来自 RAM 子账号，且策略最小化授权（别用主账号密钥）；
• 不要硬编码 AKSK，改用 oss.NewEnvironmentVariableCredentialsProvider()，环境变量名固定为 OSS_ACCESS_KEY_ID 和 OSS_ACCESS_KEY_SECRET；
• 如果跑在 ECS 上，优先用 credentials.NewECSRoleCredential()，但得确认实例已绑定 RAM 角色且权限含 oss:PutObject。
上传小文件用 PutObject 还是 PutObjectFromFile？
小文件（≤10MB）两个都行，但推荐统一用 PutObjectFromFile：
• 它自动识别文件大小，小文件走简单上传，大文件自动切片，不用你判断阈值；
• 内部流式读取 + 分块重试，不会把整个文件 load 到内存，避免 OOM；
• 支持 oss.Timeout()、oss.ContentType()、oss.ACL() 等选项，语义清晰；
• 本地路径含中文或空格？先用 url.PathEscape() 处理再传，否则可能报 InvalidObjectName；
• PutObject 的第二个参数是 io.Reader，别传 []byte 大切片，要用 bytes.NewReader() 或 strings.NewReader()（注意后者不处理 UTF-8 字节长度，中文慎用）。
上传后文件显示“无内容”或乱码怎么办？
八成是没设 Content-Type，或编码不一致：
• OSS 默认存为 binary/octet-stream，浏览器下载不渲染文本，图片也不显示缩略图；
• 显式指定类型：比如文本加 oss.ContentType("text/plain; charset=utf-8")，JSON 加 oss.ContentType("application/json")，PNG 加 oss.ContentType("image/png")；
• Go 字符串默认 UTF-8，但如果源数据含 BOM 或 GBK 编码，OSS 不做转码，直接存原始字节；
• 源文件编码不确定？先用 golang.org/x/text/encoding 转成 UTF-8 再传，别指望 OSS 自动识别；
• 注意 objectKey 区分大小写，test.jpg 和 Test.jpg 是两个不同文件，404 常因这个错。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
大文件（>100MB）上传卡住或失败怎么解？
默认 PutObject 是单次请求，超时、内存、OSS 服务端限制都会触发失败：
• 必须用 PutObjectFromFile（它内部自动走分片）或手动调 InitiateMultipartUpload → UploadPart → CompleteMultipartUpload；
• 手动分片时，每个分片 ≥100KB，partNumber 从 1 开始连续递增，跳号或重复会失败；
• 任意一步失败，必须调 AbortMultipartUpload 清理，否则产生孤儿分片（按小时计费）；
• 临时目录（默认 /tmp/aliyun-oss-go-sdk）必须可写且空间足够，可用 oss.ObjectMultipartUploadDir 指定；
• 断点续传要求 objectKey 完全一致（包括大小写），否则 SDK 当作新任务重来。
Endpoint 格式、RAM 权限、超时设置这三点，漏一个就容易卡死或 403。尤其注意 oss.New() 的 endpoint 是 Region 地址，不是 bucket 域名——这是最常被抄错的地方。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
