必须用 ctx.FormFile 读取上传图片，先校验 Content-Type 是否为 multipart/form-data，再通过 filepath.Ext() 和 mime.TypeByExtension() 双重验证 jpg/jpeg/png 格式，并在 ParseMultipartForm 中限制大小。
用 iris.Context 读取上传的图片并校验格式
Iris 的文件上传依赖 ctx.FormFile，不是直接读 body。常见错误是试图用 ctx.Body() 解析 multipart 表单，结果得到空或乱码。
必须检查 Content-Type 是否为 multipart/form-data，且表单项名（如 "image"）与前端一致。不校验扩展名或 MIME 类型，后续图像处理会 panic。
- 只允许
jpg、jpeg、png，用filepath.Ext()和mime.TypeByExtension()双重判断 - 限制单文件大小，例如
ctx.Request().MultipartReader()前设置ctx.Request().ParseMultipartForm(32 （32MB） - 调用
ctx.FormFile("image")后，立刻用file.Open()获取*os.File，别缓存file结构体本身
用 golang.org/x/image/draw 和 image/jpeg 添加文字水印
Iris 不内置图像处理，得靠标准库 + x/image。文字水印比图片水印更轻量、可控性高，适合 API 场景。别用 github.com/disintegration/imaging 这类重型库——它默认加载完整图像到内存，大图（如 5000×3000）易 OOM。
核心流程：解码 → 创建新 RGBA 图像 → 绘制原图 → 用 font.Face 渲染文字 → 编码返回。字体需预加载（如用 truetype.Parse），不能每次请求都解析 .ttf 文件。
- 水印位置建议固定在右下角：计算
dstX = bounds.Max.X - 120，dstY = bounds.Max.Y - 20 - 文字颜色用半透明白色：
color.RGBA{255, 255, 255, 128}，避免遮挡主体 - 编码时指定 JPEG 质量（如
jpeg.Options{Quality: 90}），防止二次压缩失真
通过 ctx.ServeContent 实现流式下载，不生成临时文件
别用 os.Create 写磁盘再 ctx.SendFile——既慢又占空间。API 场景应全程内存操作，用 ctx.ServeContent 直接流式输出。
关键点：设置正确的 Content-Disposition header，并提供 modtime（哪怕用 time.Now()）。否则浏览器可能不触发下载，而是尝试内嵌显示。
- 文件名需 URL-safe：
url.PathEscape("watermarked_" + originalName) -
contentLength必须准确，可用buf.Len()（若用bytes.Buffer编码）或提前计算 JPEG 大小上限 - 若水印后图像需支持透明通道（PNG），则响应头设
Content-Type: image/png，JPEG 则用image/jpeg
处理并发时的字体和解码器复用问题
多个请求同时调用 text.Draw 时，若共用未加锁的 font.Face 或 draw.Drawer，会出现文字错位或 panic。Go 标准库的 image/font 相关类型不是并发安全的。
真正安全的做法：把字体解析结果（*truetype.Font）作为全局变量初始化一次，每次请求新建 font.Face（传入不同 font.Size 和 dpi），再传给 text.Draw。
- 避免在 handler 内调用
truetype.Parse—— 它涉及大量浮点运算，CPU 密集，会阻塞 goroutine - 解码 JPEG/PNG 用
image.Decode即可，无需额外锁；但注意image.Decode对损坏图片可能 panic，务必 recover - 如果启用了 Iris 的自动 gzip 压缩（
iris.Gzip），确保图像二进制不被压缩——它已压缩过，再压反而变大
实际最易忽略的是字体度量计算的 DPI 一致性：font.Face 的 dpi 参数若与 text.Draw 中的 dot 坐标系统不匹配，水印文字会严重偏移。统一用 72.0（标准屏幕 DPI）最稳妥。
