Go解析PUT请求multipart/form-data时EOF错误的解决方法

问题背景 #

通过PUT方法接收email和image（multipart/form-data格式）的接口，始终抛出ParseMultipartForm error: multipart: NextPart: EOF错误。已确认：

• maxUploadSize设置为20MB，图片大小远低于该值
• 图片文件存在、路径正确
• 使用curl和Insomnia测试均出现相同错误

测试用curl命令 #

curl --request PUT \
  --url http://localhost:8080/upload-image \
  --header 'Content-Type: multipart/form-data' \
  --form email=john.doe@test.com \
  --form image=@/home/images/ad.jpg

请求对象打印信息 #

&{Method:PUT URL:/upload-image Proto:HTTP/1.1 ProtoMajor:1 ProtoMinor:1 Header:map[Accept:[*/*] Content-Length:[22941] Content-Type:[multipart/form-data; boundary=------------------------111a7e49ac62697b] User-Agent:[curl/7.81.0]] Body:0xc000450200 GetBody:<nil> ContentLength:22941 TransferEncoding:[] Close:false Host:localhost:8080 Form:map[] PostForm:map[] MultipartForm:<nil> Trailer:map[] RemoteAddr:127.0.0.1:59296 RequestURI:/upload-image TLS:<nil> Cancel:<nil> Response:<nil> ctx:0xc000592000 pat:<nil> matches:[] otherValues:map[]}

核心代码 #

type UploadImageRequest struct {
    Email string `json:"email"`
}

func (api *Api) ValidateRequest(w http.ResponseWriter, r *http.Request) (*UploadImageRequest, error) {
    r.Body = http.MaxBytesReader(w, r.Body, maxUploadSize)

    err := r.ParseMultipartForm(maxUploadSize)
    if err != nil {
        log.Printf("ParseMultipartForm error: %v", err)
        return nil, err
    }

    email := r.FormValue("email")
    if email == "" {
        return nil, err
    }

    return &UploadImageRequest{
        Email: email,
    }, nil
}

func (api *Api) UploadImage(w http.ResponseWriter, r *http.Request) {
    fmt.Println("%+v", r)

    uploadImageRequest, err := api.ValidateRequest(w, r)
    if err != nil {
        api.app.Respond(err, w, nil)
        return
    }

    image := r.MultipartForm.File["image"]
    if len(image) == 0 {
        api.app.RespondError(nil, w, http.StatusBadRequest, "Image file is required")
        return
    }
    // ...
}

排查与解决方法 #

1. 移除http.MaxBytesReader的不必要使用 #

http.MaxBytesReader会在读取到指定字节数后直接关闭请求体，而ParseMultipartForm内部需要完整读取整个multipart内容，这会导致请求体被提前截断，触发EOF错误。ParseMultipartForm本身的maxMemory参数已经可以处理大小限制：超过该值的文件会被写入临时文件，无需额外用MaxBytesReader截断。

修改后的ValidateRequest函数：

import "errors"

func (api *Api) ValidateRequest(w http.ResponseWriter, r *http.Request) (*UploadImageRequest, error) {
    // 移除这一行：r.Body = http.MaxBytesReader(w, r.Body, maxUploadSize)

    err := r.ParseMultipartForm(maxUploadSize)
    if err != nil {
        log.Printf("ParseMultipartForm error: %v", err)
        return nil, err
    }

    email := r.FormValue("email")
    if email == "" {
        return nil, errors.New("email is required") // 替换原代码的错误返回，避免混淆Parse错误
    }

    return &UploadImageRequest{
        Email: email,
    }, nil
}

2. 避免请求体被提前读取 #

UploadImage函数中fmt.Println("%+v", r)如果触发了请求体的隐式读取（或其他中间件提前读取了Body），会导致ParseMultipartForm无法获取完整内容。确保在调用ParseMultipartForm之前，没有任何代码读取请求体，如需打印请求信息，可在解析完成后操作。

3. 验证PUT请求的multipart兼容性 #

虽然HTTP标准允许PUT使用multipart/form-data，但部分框架或中间件可能对PUT请求的处理有差异。可以临时将请求方法改为POST测试，若能正常解析，则需检查路由绑定或中间件是否拦截了PUT请求的multipart处理。

4. 检查curl请求的完整性 #

添加--trace-ascii debug.log参数生成详细请求日志，确认multipart边界和内容是否完整：

curl --request PUT \
  --url http://localhost:8080/upload-image \
  --header 'Content-Type: multipart/form-data' \
  --form email=john.doe@test.com \
  --form image=@/home/images/ad.jpg \
  --trace-ascii debug.log

查看日志中是否有完整的文件内容，以及multipart边界是否正确闭合。

内容的提问来源于stack exchange，提问作者Yuri Costa