必须显式设置Content-Type并用ctx.ResponseWriter().Write()输出图片二进制流,禁用模板渲染与Gzip压缩,校验路径防遍历,避免混用http.ServeFile或os.Open。

iris.Context.Write和Writef不能直接输出图片二进制流
直接用 ctx.Write([]byte{...}) 写入 PNG/JPEG 二进制数据,浏览器大概率会显示乱码或下载提示——因为缺少正确的 Content-Type 和 Content-Length 响应头。Iris 不会自动推断你写的是图片,它只当普通文本处理。
必须显式设置响应头并调用ctx.ResponseWriter().Write()
动态生成图片(比如用 image/png 包绘图)后,要手动设置 MIME 类型、禁用默认的 HTML 模板渲染,并确保写入的是原始字节流:
-
ctx.ContentType("image/png")是必须的,不能省略;"image/jpeg"同理 - 避免使用
ctx.JSON()或ctx.View(),它们会覆盖响应头或添加额外内容 - 用
ctx.ResponseWriter().Write(data)而非ctx.Write(data),前者绕过中间件对 body 的潜在修改(如压缩) - 如果图片较大,考虑加
ctx.Header("Cache-Control", "public, max-age=3600")减少重复请求
常见错误:用http.ServeFile或os.Open导致路径暴露或404
想返回磁盘上动态生成的图片时,别用 http.ServeFile 或直接 os.Open + io.Copy —— Iris 的 ctx 不是标准 http.ResponseWriter,混用会导致 panic 或 header 冲突。正确做法是:
- 读取文件到
[]byte,再按上一条方式设置头 +Write() - 若需流式传输大图,用
ctx.ResponseWriter().WriteHeader(200)+io.Copy(ctx.ResponseWriter(), file),但务必提前设好Content-Type - 绝对路径必须校验,防止目录遍历:
filepath.Clean(path)后再拼接根目录
生成验证码或图表时记得关闭 Gzip 压缩
图片本身已是压缩格式,开启 iris.Compression 中间件会导致二进制损坏。在路由注册时单独跳过:
app.Get("/captcha", func(ctx iris.Context) {
ctx.DisableBodyConsumptionOnUnmarshal(true)
ctx.ContentType("image/png")
// ...生成图片逻辑
ctx.ResponseWriter().Write(pngData)
})
// 不要在这里 Use(iris.Compression)
更稳妥的做法是在该 handler 开头加 ctx.StopExecution() 阻止后续中间件运行,尤其当你全局启用了压缩或日志中间件时。











