c.FormFile() 返回 nil 是因 multipart 请求体构造错误或解析未触发;需用 bytes.Buffer + multipart.Writer 正确构建,字段名匹配、调用 writer.Close()、设置动态 Content-Type,并确保无中间件提前读取 Body。

c.FormFile() 在测试中返回 nil,不是 Gin 有 bug,而是 multipart 请求体没构造对,或者解析流程根本没触发。
用 bytes.Buffer + multipart.Writer 构造合法的文件上传请求体
手写 raw body 容易出错:漏掉空行、boundary 结束符、字段名不匹配、Content-Type 头不一致——这些都会让 c.FormFile("file") 返回 nil。
- 必须用
bytes.Buffer包裹multipart.Writer,调用writer.CreateFormFile("file", "test.png")创建字段,字段名要和 handler 里c.FormFile(...)的第一个参数完全一致 - 写完内容后必须调用
writer.Close(),否则请求体不完整,ParseMultipartForm失败 -
req.Header.Set("Content-Type", writer.FormDataContentType())是必须的,这个值由writer动态生成,不能硬编码 - 空文件测试可用
writer.CreateFormFile("file", ""),它仍会返回非nil的*multipart.FileHeader,业务逻辑可继续判断Size == 0
确保 c.FormFile() 被实际调用,且中间件不提前消费 Request.Body
Gin 只在首次调用 c.MultipartForm()、c.FormFile() 或 c.PostForm() 时才解析 body;如果中间件(比如日志、鉴权)读了 c.Request.Body 却没重放,后续就再也读不到 multipart 数据。
- 在 handler 开头加
fmt.Printf("form: %+v\n", c.MultipartForm()),看是否为nil—— 是最直接的验证方式 - 测试前务必设
gin.SetMode(gin.TestMode),否则默认中间件(如 recovery、logger)可能 panic 或刷屏干扰断言 - 避免在测试中调用
c.GetRawData()或ioutil.ReadAll(c.Request.Body),这会直接关掉 body 流 - 如果用了自定义中间件读 body,必须用
httptest.NewRecorder()配合req.Body = ioutil.NopCloser(bytes.NewReader(data))手动重放
测试边界情况:超限、空文件、非法扩展名
Gin 不做文件校验,所有校验逻辑都在 handler 内。测试目标不是“Gin 是否支持”,而是“你的 if 分支是否走对”。
- 文件大小超限:先用
router.MaxMultipartMemory = 1 (1MB)设限,再传一个 2MB 的 buffer,确保 handler 拿到 <code>file.Size > 1 后返回对应错误 - 非法扩展名:构造
writer.CreateFormFile("file", "evil.exe"),检查 handler 是否拦截并返回 400 - 多个文件字段:用两次
CreateFormFile,验证是否能正确取到c.FormFile("avatar")和c.FormFile("cover") - 混合字段(文件 + 普通表单):用
writer.WriteField("name", "alice"),再验证c.PostForm("name")是否可读
用 assert.JSONEq 断言响应,别用 assert.Equal 直接比字符串
Go 的 map 序列化 JSON 时 key 顺序不固定,assert.Equal(t, `{"code":0,"msg":"ok"}`, w.Body.String()) 很容易因字段顺序抖动失败。
- 一律用
assert.JSONEq(t, `{"code":0,"msg":"ok"}`, w.Body.String()),它会反序列化后结构比对,容忍空格、换行、key 顺序 - 如果 handler 返回的是二进制(比如
c.Data)、或设置了Content-Encoding,别用w.Body.String(),改用w.Body.Bytes()配合bytes.Equal - 测试非 JSON 响应(如纯文本、XML)时,记得设置对应
Content-Type头,并用strings.TrimSpace(w.Body.String())去首尾空白再比对
c.FormFile() 就静默返回 nil。


















