Gin框架大文件上传异常：校验后Postman报错ECONNRESET/503

问题背景 #

在基于Gin的文件上传服务中，通过中间件校验Content-Length，超过阈值返回413错误；客户端需设置Expect:100-continue头避免大文件上传触发503。但实际使用Postman上传大文件时：

• 频繁出现Could not get response" Error: read ECONNRESET，但服务器日志显示已返回413
• 添加Connection: close、全量丢弃请求体的代码后，又出现服务器响应过慢、连接阻塞，Postman返回503

问题根源 #

1. ECONNRESET错误：服务器返回413后直接终止请求，但客户端仍在持续上传大文件数据，导致TCP连接被强制中断，客户端捕获到连接重置错误。
2. 503/连接阻塞：使用io.Copy(io.Discard, c.Request.Body)会强制读取完整个大文件的请求体才关闭连接，这个过程耗时过长，引发网关超时或连接资源被占用。

解决方案 #

1. 优化中间件：快速终止请求，不全量读取请求体 #

修改中间件逻辑，在返回413时仅读取少量请求体清空缓冲区，同时明确告知客户端关闭连接，避免后续数据传输：

const MAX_FILE_SIZE = 10 << 20 // 示例：10MB

func SizeHandler() gin.HandlerFunc {
    return func(c *gin.Context) {
        // 校验Content-Length是否超限
        if c.Request.ContentLength > MAX_FILE_SIZE {
            // 告知客户端关闭连接，停止发送数据
            c.Writer.Header().Set("Connection", "close")
            // 仅读取1KB数据清空缓冲区，避免TCP阻塞
            _, _ = io.CopyN(io.Discard, c.Request.Body, 1024)
            // 关闭请求体释放资源
            _ = c.Request.Body.Close()
            // 返回413错误
            c.AbortWithStatusJSON(http.StatusRequestEntityTooLarge, gin.H{"error": "请求体过大"})
            return
        }

        // 处理Expect:100-continue请求，返回100 Continue允许客户端上传
        if c.Request.Header.Get("Expect") == "100-continue" {
            c.Writer.WriteHeader(http.StatusContinue)
            c.Writer.Flush()
        }

        c.Next()
    }
}

2. 配置服务器超时参数 #

启动Gin时设置合理的读取超时和空闲超时，避免因连接长时间占用导致的503：

func main() {
    r := gin.Default()
    r.Use(SizeHandler())
    // 配置上传路由...

    srv := &http.Server{
        Addr:         ":8080",
        Handler:      r,
        ReadTimeout:  10 * time.Second,  // 读取请求的超时时间
        IdleTimeout:  30 * time.Second,  // 空闲连接超时时间
    }
    if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
        log.Fatalf("服务器启动失败: %s", err)
    }
}

3. Postman客户端调整 #

• 确保请求头中包含Expect: 100-continue（可在Headers面板手动添加）
• 适当延长请求超时时间（路径：Settings -> General -> Request timeout）
• 关闭"Automatically follow redirects"选项，避免重定向引发的异常

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