直接调用gin.Context.SaveUploadedFile保存图片出错，是因为Gin默认不解析multipart表单，c.FormFile("image")返回nil导致panic；须先调用c.Request.ParseMultipartForm(32<<20)解析表单。
为什么直接用 gin.Context.SaveUploadedFile 保存图片再处理会出错
常见现象是上传后服务卡住、返回空响应，或提示 http: request body too large。根本原因是 Gin 默认不自动解析 multipart 表单中的文件字段，c.FormFile("image") 返回 nil 时还继续调用 SaveUploadedFile，导致 panic 或静默失败。
必须显式调用 c.Request.ParseMultipartForm（或确保 MaxMultipartMemory 足够），且需在读取文件前完成解析：
// 正确顺序
c.Request.ParseMultipartForm(32 << 20) // 32MB 内存限制
file, err := c.FormFile("image")
if err != nil {
c.JSON(400, gin.H{"error": "no file uploaded"})
return
}
- 不设
ParseMultipartForm，FormFile总是返回 nil -
MaxMultipartMemory默认是 32MB，但若前端传了超大图（如 50MB 原图），需提前在gin.Default()后设置：r.MaxMultipartMemory = 64 - 水印逻辑不能阻塞主线程，大图处理耗时高，建议用 goroutine + channel 控制并发，或接消息队列
用 golang.org/x/image/draw 叠加文字水印时字体渲染模糊
直接用 font.Face 渲染文字，常出现锯齿严重、中文乱码、位置偏移——因为默认没加载字体，也没做 sub-pixel 渲染和 DPI 适配。
关键步骤是：用 truetype.Parse 加载 .ttf 文件，构造 font.Face 时指定 Hinting 和 Size，再用 draw.DrawMask 而非 draw.Draw：
立即学习“go语言免费学习笔记（深入）”；
tt, _ := truetype.Parse(fontBytes)
face := truetype.NewFace(tt, &truetype.Options{
Size: 24,
Hinting: font.HintingFull,
})
d := &font.Drawer{
Dst: img,
Src: image.Black,
Face: face,
Dot: fixed.Point26_6{
X: fixed.I(50),
Y: fixed.I(100),
},
Text: "© 2024",
}
font.Drawer.Draw(d)
- 字体文件必须是 TrueType（.ttf），OpenType（.otf）需转换或换库
- 中文需选含 CJK 字符的字体（如 NotoSansCJK.ttc），否则
Draw不报错但显示方块 - 坐标
Dot单位是fixed.Point26_6，不是像素，X/Y 要用fixed.I(x)转换
如何让水印位置随图片尺寸自适应（比如右下角 20px 边距）
硬编码 X=800,Y=600 在不同分辨率图片上会错位。正确做法是先用 image.Decode 读取原始尺寸，再计算相对坐标。
注意：Gin 接收的 *multipart.FileHeader 是个指针，Open() 后得到的 io.ReadSeeker 需要 seek(0) 才能重复读取（一次解码尺寸，一次解码图像数据）：
src, _ := file.Open() defer src.Close() <p>// 第一次读：获取尺寸 config, <em>, </em> := image.DecodeConfig(src) src.Seek(0, 0) // 重置读取位置</p><p>// 第二次读：解码图像 img, <em>, </em> := image.Decode(src)</p><p>// 计算右下角水印位置 x := config.Width - 20 - int(float64(config.Width)*0.1) // 右侧留 10% + 20px y := config.Height - 20
-
DecodeConfig比完整Decode快得多，适合只取宽高场景 - 忘记
Seek(0, 0)会导致第二次Decode失败，错误信息是invalid format: unknown format - 水印大小也应按比例缩放，比如字号设为
float64(config.Height) * 0.03
返回加水印后的图片时，为什么浏览器下载的是 .bin 文件而不是预览
典型表现：接口返回二进制数据，但浏览器不渲染图片，而是弹出下载框，文件名是随机字符串或 download.bin。问题出在响应头缺失或错误。
必须手动设置 Content-Type 和 Content-Disposition，且 Content-Type 要与实际编码格式严格一致（如 JPEG 图像不能写 image/png）：
c.Header("Content-Type", "image/jpeg")
c.Header("Content-Disposition", `inline; filename="watermarked.jpg"`)
jpeg.Encode(c.Writer, img, &jpeg.Options{Quality: 90})
- 用
inline而非attachment才可能触发浏览器内联预览 - 文件扩展名要和
Content-Type匹配，否则部分浏览器（如 Safari）拒绝渲染 - 如果原图是 PNG，必须用
png.Encode并设Content-Type: image/png，混用会损坏输出
Gin 做图片水印服务最易忽略的点是：上传解析、图像解码、内存释放、响应头这四个环节任意一个断链，都会导致静默失败或前端不可用。尤其 Seek(0,0) 和 Content-Type 匹配，线上查问题时往往花半天才定位到。
