必须显式设置最大内存限制,Iris 默认不限制 multipart 请求,ctx.ReadForm 和 ctx.FormFile 会将整个文件读入内存导致 OOM;需手动调用 ctx.SetMaxRequestBodySize(10

上传接口必须显式设置最大内存限制
Iris 默认对 multipart 请求不做内存限制,但 ctx.ReadForm 和 ctx.FormFile 在解析时会把整个文件先读进内存——大文件直接 OOM。不设限等于默认 32MB(Go 标准库行为),但这个值不会自动生效,必须手动调用 app.ConfigureContainer 或在路由 handler 里提前调用 ctx.SetMaxRequestBodySize。
ctx.SetMaxRequestBodySize(10 设置单次请求最大 10MB(推荐放在中间件或 handler 开头)- 不要依赖
app.UseGlobal统一设——它只影响全局中间件链,不改变底层 multipart 解析器的缓冲区大小 - 若用
ctx.ReadForm(0)的 0 表示“不限”,实际会触发 panic,必须传具体字节数
FormFile 和 FormValue 混用时路径参数优先级高于表单字段
当 POST /upload?id=123 同时带 file 字段和 query 参数,ctx.FormValue("id") 返回空字符串,因为 id 是 URL 查询参数,不是 form 字段;而 ctx.URLParam("id") 才正确返回 "123"。常见错误是误以为所有参数都可通过 FormValue 统一取。
-
ctx.FormFile("file")只读 multipart 中的文件字段,不处理 query 或 path 参数 -
ctx.Param("id")仅匹配路径中定义的:id段,比如/upload/:id才能用 - 混合参数场景建议统一用结构体绑定:
ctx.ReadForm(&uploadReq),但需确保 struct tag 匹配 form key 名
保存文件前必须检查 Header.Size 防止恶意空文件或超限
ctx.FormFile 返回的 *multipart.FileHeader 有 Size 字段,但它只是 header 中声明的大小,不校验实际内容——攻击者可伪造小 size + 大 payload 导致磁盘写满。必须结合 ctx.GetContentLength() 或流式读取做二次校验。
- 先调
file, err := ctx.FormFile("file"),再判断if file.Size > 10 -
file.Open()返回的multipart.File是io.ReadCloser,务必 deferfile.Close() - 保存到磁盘时用
ioutil.WriteFile不安全,应改用os.Create+io.Copy流式写入,避免内存峰值
多文件上传不能用 ctx.FormFile 循环调用
ctx.FormFile("files") 只返回第一个匹配的文件,即使 HTML 表单用了 name="files[]" 或多个 name="files" 字段。Iris 不自动聚合同名字段,必须用 ctx.FormFiles("files")(注意复数)获取切片。
-
files, err := ctx.FormFiles("files")返回[]*multipart.FileHeader,长度即上传文件数 - 每个
file都要单独file.Open()和defer file.Close() - 若前端用
FormData.append("files", blob1); FormData.append("files", blob2),后端必须用FormFiles,否则只拿到第一个
最易被忽略的是:上传完成后没清空临时文件。Iris 使用 Go 标准库 multipart.Reader,临时文件由 os.TempDir() 创建,不手动清理会在磁盘累积。建议在 handler 结尾加 os.RemoveAll(os.TempDir()) 不现实——会影响其他进程,稳妥做法是用 file.Open() 后立即流式处理,避免落盘临时文件。或者在启动时调 iris.TemporaryDirectory("./uploads/tmp") 指定可控目录,定期轮转清理。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











