c.FormFile返回的文件句柄不能直接压缩,必须先用io.Copy保存到唯一临时路径并确认file.Close()成功后,再读取该路径启动压缩;否则因数据未落盘会导致压缩失败或损坏。

c.FormFile 返回的文件句柄不能直接压缩,必须先落地再处理
上传后立刻调 jpeg.Encode 或 png.Encode 会失败——因为 c.FormFile 返回的是内存或临时磁盘上的未完成句柄,底层数据可能还没刷写完毕。Fiber 的 multipart 解析不保证文件内容已完整就位,尤其在大图(>2MB)或网络抖动时。正确路径是:先用 io.Copy 把内容保存到唯一临时路径,显式调用 file.Close() 并检查 error,确认 fd 已释放、数据已落盘,再读取该路径启动压缩。
- 必须调
r.ParseMultipartForm(32 ,否则 <code>c.FormFile可能返回nil或 panic - 临时路径用
os.CreateTemp("", "avatar-*.bin"),避免并发覆盖或冲突 -
file.Close()的 error 一定要检查,忽略它会导致后续os.Open失败(“text file busy” 或 “permission denied”) - 不要依赖
header.Size做压缩前判断——客户端可伪造,真实大小得靠os.Stat或读取前 512 字节校验 magic bytes
http.MaxBytesReader 是上传阶段唯一的前置防线
Fiber 没有全局上传大小限制,c.FormFile 调用前若不包装请求体,攻击者可发 10GB 请求拖垮服务。必须在 handler 开头第一行用 http.MaxBytesReader 包装 c.Request().Body,且总上限要包含所有字段(文本 + 文件),不能只按单文件算。
立即学习“go语言免费学习笔记(深入)”;
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 示例:允许头像 ≤ 5MB,外加标题/描述等文本字段约 2KB,建议设为
6 <em> 1024 </em> 1024 - 错误写法:
c.ParseForm()或c.FormFile()先执行,再换 Body —— 此时 multipart 解析器已隐式触发,拦截失效 -
file.Size仅作业务层二次校验,不能替代流控;它来自 boundary 解析,非真实字节数
图片压缩优先调质量参数,不是尺寸
单纯缩放易导致模糊、锯齿或透明背景变黑。对头像这类强调人像细节的场景,应先固定输出尺寸(如 200×200),再用 JPEG 质量参数反复试探,直到文件 ≤ 目标大小(如 150KB)。PNG 则保留 Alpha 通道,别用 draw.NearestNeighbor 这类丢精度的重采样器。
- JPEG 推荐起始质量
90,每步降5,用jpeg.Encode(dst, img, &jpeg.Options{Quality: q}) - 缩放必须新建
image.RGBA目标图,不能复用原图矩形区域 - PNG 透明图压缩失败常见原因是没传
png.Encoder的CompressionLevel参数,默认不压缩
异步压缩更安全,但得自己管清理
头像上传后同步压缩会阻塞 HTTP 连接,大图可能超时。推荐扔进 Asynq 队列,由 worker 异步处理。但要注意:worker 中压缩失败时,必须显式 os.Remove 临时文件,不能只靠 defer —— panic 或磁盘满时 defer 可能来不及执行。
- 临时路径需随任务一起序列化进 job payload,避免 worker 读错文件
- 压缩成功后,再把最终图 mv 到正式目录(如
./uploads/avatars/uid.jpg),并删临时文件 - 若压缩失败,记录 error 并主动
os.Remove,否则/tmp会慢慢被占满
最易被忽略的是:压缩逻辑和文件保存的耦合性。哪怕你用了 zstd 流式压缩库,只要 file.Close() 的 error 没检查,底层 fd 就锁着临时文件,后续 os.Open 会一直失败。

















