storage.putfile不支持相对路径，因内部调用os.open时依赖当前工作目录，易报“file does not exist”；须用filepath.abs转绝对路径，并检查ret.key非空、zone匹配bucket区域、token动态生成。
storage.PutFile 传相对路径为什么总报 file does not exist
Go SDK 的 PutFile 不接受相对路径，它内部调用 os.Open 时直接拼接当前工作目录，一旦你用 "./uploads/photo.jpg" 或 "~/Downloads/a.png"，就会 panic 或返回 “file does not exist” 错误（哪怕文件真实存在）。
实操建议：
- 用
filepath.Abs转成绝对路径再传：absPath, _ := filepath.Abs("./uploads/photo.jpg") - 避免路径含中文、空格、波浪号（
~）、反斜杠（\），这些字符在不同系统下解析行为不一致 - 上传前先
os.Stat(absPath)检查文件是否存在且可读，别等PutFile失败才处理
uploadToken 生成错或复用过期导致 401 却不报 err
PutFile 成功返回 err == nil 并不表示上传成功——token 过期、scope 错误、AK/SK 权限不足时，七牛服务端返回 HTTP 401，但 SDK 默认把这类响应转为 err == nil，只把 ret.Key 置空。
实操建议：
- 必须显式检查
ret.Key != ""，不能只依赖err == nil - token 必须用
storage.PutPolicyV2+SignV2生成，旧版PutPolicy已废弃，会静默失败 - token 有效期默认 3600 秒，别缓存复用；每次上传前动态生成，且确保
Scope填的是 bucket 名（如"my-app-2024"），不是域名或外链地址
Zone 配置不匹配引发超时或 503，但编译和运行都不报错
storage.Config 中不设 Zone 字段，SDK 会 fallback 到默认华东区域。若你的 bucket 实际在华北，请求会被跨区转发，增加延迟，高并发时可能触发限流，返回 503 或连接超时——而 Go 编译完全不提示，运行时也无明确错误日志。
实操建议：
- 登录七牛云控制台，在 bucket 设置页确认「存储区域」，严格对应使用：
&storage.ZoneHuabei（华北）、&storage.ZoneHuanan（华南）、&storage.ZoneHuadong（华东） - 别用
storage.ZoneAuto，新版 SDK 已移除该常量，硬写会导致编译失败 - 如果不确定区域，宁可先用
curl -v https://api.qiniu.com/v2/regions查接口，也不要靠猜
大文件上传用 PutFile 还是 Put？内存和稳定性怎么权衡
PutFile 内部会全量读入内存再发请求，>100MB 文件容易触发 OOM；而 Put 接收 io.Reader，可配合 bufio.NewReader 控制缓冲区大小，适合流式上传、加密内容或 Gin 中的 c.FormFile 场景。
实操建议：
- 本地磁盘小文件（PutFile，代码最简
- HTTP 表单上传、加密后字节流、需进度回调、文件 >50MB → 必须用
Put，传bytes.NewReader(data)或fileContent（已打开的*os.File） - 上传前加
os.Stat获取文件大小，>50MB 就切到Put路径，别等到 OOM 才改逻辑
ret.Key 是否被当成成功标志来用——这三处没验证，上传就等于盲发。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
