golang怎么传到oss

直接使用 aliyun/aliyun-oss-go-sdk/oss SDK 就行，别自己拼 HTTP 请求——签名、超时、分片、断点续传这些坑，一个比一个深，自己兜底太容易翻车。初始化 client 时常见的 panic 或 403，大多出在两点：endpoint 格式写错（必须是 https://oss-cn-hangzhou.aliyuncs.com 这种完整地址），或者凭据没走对链路（得用 RAM 子账号，环境变量配好 OSS_ACCESS_KEY_ID 和 OSS_ACCESS_KEY_SECRET，或者 ECS 实例角色）。

初始化 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，省心不少：

• 它会自动识别文件大小：小文件走简单上传，大文件自动切片，不用你手动判断阈值。
• 内部是流式读取 + 分块重试，不会把整个文件一次性加载到内存，避免 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 都是这个低级错误。

大文件（>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 域名——这是最容易抄错的地方。