Go HTTP文件上传处理：大文件远超限制时静默失败，触发连接重置

问题原因 #

你遇到的问题根源在于http.MaxBytesReader的行为特性：当检测到请求体大小超过限制时，它会自动向ResponseWriter写入413（请求实体过大）状态码，并立即关闭底层连接。

• 当文件略超限制时，客户端可能已经完成了所有数据的发送，服务器在连接关闭前还能把自定义错误页面发送出去，所以浏览器能正常接收；
• 当文件远大于限制时，客户端仍在持续发送数据，此时连接被强制关闭，客户端就会收到ERR_CONNECTION_RESET错误，自然无法接收你的自定义错误页面。

另外，你后续调用template.Execute或http.Redirect时，http.MaxBytesReader已经提前写入了413状态码，导致响应头冲突，进一步加剧了问题。

解决方案 #

替换http.MaxBytesReader为io.LimitReader（不会自动关闭连接或写入状态码），同时结合Content-Length预检查，实现自定义的大小限制逻辑：

import (
    "io"
    "net/http"
    "strings"
    "html/template"
)

const maxUploadSize = 20 << 20 // 20MB

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    var dataStruct struct {
        Errors []string
        // 其他业务字段...
    }

    // 1. 先检查Content-Length（如果请求头中存在）
    if r.ContentLength > maxUploadSize {
        dataStruct.Errors = append(dataStruct.Errors, "image_too_large")
        w.WriteHeader(http.StatusOK)
        if err := template.Execute(w, dataStruct); err != nil {
            http.Error(w, err.Error(), http.StatusInternalServerError)
        }
        return
    }

    // 2. 对Chunked编码的请求，用io.LimitReader限制读取字节数
    r.Body = io.LimitReader(r.Body, maxUploadSize)

    // 3. 解析Multipart表单
    if err := r.ParseMultipartForm(maxUploadSize); err != nil {
        // 判断是否为请求体过大导致的错误
        if strings.Contains(err.Error(), "request body too large") || strings.Contains(err.Error(), "unexpected EOF") {
            dataStruct.Errors = append(dataStruct.Errors, "image_too_large")
            w.WriteHeader(http.StatusOK)
            if err := template.Execute(w, dataStruct); err != nil {
                http.Error(w, err.Error(), http.StatusInternalServerError)
            }
            return
        }
        // 处理其他表单解析错误
        http.Error(w, "表单解析失败: "+err.Error(), http.StatusInternalServerError)
        return
    }

    // 正常处理上传逻辑...
}

关键说明 #

• Content-Length预检查：快速拦截有明确大小标识的超大请求，避免不必要的IO操作；
• io.LimitReader：仅限制读取的字节数，不会主动关闭连接或修改响应头，让你能完全控制错误响应的内容；
• 错误判断：ParseMultipartForm返回的unexpected EOF通常是因为io.LimitReader提前终止了读取，可视为请求体过大的信号。

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