Gin框架使用c.ShouldBindJSON前是否需显式处理gzip压缩JSON请求

核心问题解答 #

首先明确：Gin v1.7.4默认没有内置请求体的gzip解压逻辑，调用c.ShouldBindJSON前必须对gzip压缩的请求体做显式解压处理。
你遇到的报错是因为直接把gzip的二进制流当成纯JSON解析，\x1f是gzip文件的标准魔术头标识，所以JSON解析器识别失败。

方案1：全局Gzip请求解压中间件（推荐） #

通过中间件统一处理所有请求的gzip解压逻辑，对上层业务代码无侵入，原有普通JSON请求的逻辑不需要任何改动，兼容性更强：

package main

import (
    "compress/gzip"
    "github.com/gin-gonic/gin"
    "log"
    "net/http"
    "strings"
)

// GzipDecompressMiddleware gzip请求解压中间件
func GzipDecompressMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        // 判断请求内容是否为gzip压缩
        if strings.Contains(c.GetHeader("Content-Encoding"), "gzip") {
            // 初始化gzip读取器
            gr, err := gzip.NewReader(c.Request.Body)
            if err != nil {
                c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "无效的gzip压缩内容"})
                return
            }
            defer gr.Close()
            // 替换原始请求体为解压后的读取流
            c.Request.Body = gr
        }
        c.Next()
    }
}

func main() {
    r := gin.Default()
    // 注册全局解压中间件
    r.Use(GzipDecompressMiddleware())

    r.POST("/postgzip", func(c *gin.Context) {
        type PostData struct {
            Data string `binding:"required" json:"data"`
        }
        var postdata PostData
        // 原有绑定逻辑完全不需要修改
        if err := c.ShouldBindJSON(&postdata); err != nil {
            log.Println("解析请求体失败", "error", err)
            c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
            return
        }
        log.Printf("%+v", postdata)
        c.String(200, postdata.Data)
    })
    r.Run()
}

修改后重新运行服务，你给出的gzip测试请求即可正常返回hello。

方案2：单接口内显式解压 #

如果只有个别接口需要处理gzip压缩请求，不想加全局中间件，可以直接在对应接口内处理解压逻辑：

r.POST("/postgzip", func(c *gin.Context) {
    type PostData struct {
        Data string `binding:"required" json:"data"`
    }
    var postdata PostData
    var err error

    // 判断是否为gzip压缩请求
    if strings.Contains(c.GetHeader("Content-Encoding"), "gzip") {
        gr, err := gzip.NewReader(c.Request.Body)
        if err != nil {
            log.Println("无效的gzip压缩内容", err)
            c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "无效的gzip压缩内容"})
            return
        }
        defer gr.Close()
        // 从解压后的流绑定JSON
        err = c.ShouldBindBodyWith(&postdata, binding.JSON.Bind(gr, &postdata))
    } else {
        // 普通JSON请求走原有逻辑
        err = c.ShouldBindJSON(&postdata)
    }

    if err != nil {
        log.Println("解析请求体失败", "error", err)
        c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": err.Error()})
        return
    }
    log.Printf("%+v", postdata)
    c.String(200, postdata.Data)
})

注意事项 #

• 解压完成后必须调用gzip.Reader的Close()方法释放资源
• 如果需要支持deflate等其他压缩格式，可扩展中间件逻辑添加对应解压处理

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