Gin框架中ShouldBind方法绑定多个参数结构体时，为何会出现冲突？

gin的shouldbind方法冲突问题

在gin框架中，使用shouldbind方法绑定请求参数时，可能会遇到冲突问题。该问题通常表现为，当同时绑定多个参数结构体时，只有一个结构体能成功绑定，而其他结构体会为空值。

示例

// package models
type listreqinfo struct {
    keyword   string `form:"keyword" default:""`                       //模糊关键字
    pagenum   int    `form:"pagenum" binding:"required" default:"1"`   //页数
    pagesize  int    `form:"pagesize" binding:"required" default:"10"` //页大小
    ordername string `form:"ordername" default:"created_on"`           //排序列
    ordertype string `form:"ordertype" default:"desc"`                 //排序方式 desc asc
}

// @tags 文章
// @summary 分页获取文章
// @produce  json
// @param reqinfo body models.listreqinfo false "info"
// @success 200 {object} app.response
// @failure 500 {object} app.response
// @router /api/v1/article/list [post]
func (a article) list(c *gin.context) {
    var (
        appg     = app.gin{c: c}
        param    models.listreqinfo
        parammap map[string]interface{}
    )

    // 冲突：同时绑定两个参数结构体
    if err := c.shouldbind(¶m); err != nil {
        appg.responseerror(http.statusbadrequest, err.error())
        return
    }

    if err := c.shouldbind(¶mmap); err != nil {
        appg.responseerror(http.statusbadrequest, err.error())
        return
    }
}

问题原因

Peachly AI

Peachly AI是一个一体化的AI广告解决方案，帮助企业创建、定位和优化他们的广告活动。

下载

这个问题的原因是gin的shouldbind方法在绑定过程中会将请求body中的值缓存到上下文中。当第二个结构体绑定时，请求body中的值已经被消耗，导致参数填充失败。

解决方案

解决这个问题的方法是使用gin提供的c.shouldbindbodywith方法，该方法可以指定绑定特定的body数据类型，例如json数据。

func (a Article) List(c *gin.Context) {
    var (
        appG     = app.Gin{C: c}
        param    models.ListReqInfo
        paramMap map[string]interface{}
    )

    // 解决方案：使用c.ShouldBindBodyWith
    if err := c.ShouldBindBodyWith(¶m, binding.JSON); err != nil {
        appG.ResponseError(http.StatusBadRequest, err.Error())
        return
    }

    // ...
}