Gin Gonic如何实现同时绑定query与JSON类型的多个请求参数

Gin 原生没有提供直接的ShouldBindAllAPI，但可以通过组合内置绑定器、封装通用方法实现需求，无需重复编写多次绑定逻辑。

方案1：直接使用原生绑定器组合 #

Gin 的ShouldBindWith方法支持指定不同的绑定实现，依次调用 JSON 和 Query 绑定器即可，已绑定的非空字段不会被后续绑定的空值覆盖，刚好匹配同时读取 JSON 请求体和 URL 查询参数的需求。
示例代码：

import (
    "github.com/gin-gonic/gin"
    "github.com/gin-gonic/gin/binding"
    "net/http"
    "log"
)

type Params struct {
  Userid string `form:"user_id" json:"user_id" binding:"required"`
  Password string `json:"password" binding:"required"`
}

func Create(c *gin.Context) {
  var params Params
  // 先绑定JSON请求体
  if err := c.ShouldBindWith(&params, binding.JSON); err != nil {
      c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
      return
  }
  // 再绑定Query参数，不会覆盖已经绑定的非空字段
  if err := c.ShouldBindWith(&params, binding.Query); err != nil {
      c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
      return
  }
  log.Println("绑定完成", params)
  // 后续业务逻辑
}

方案2：封装通用ShouldBindAll扩展方法 #

如果多接口都需要该能力，可以把多绑定逻辑封装为通用方法，实现你期望的调用效果：
首先定义通用绑定方法：

// ShouldBindAll 同时绑定多来源参数，按顺序绑定，已有值不会被后续空值覆盖
func ShouldBindAll(c *gin.Context, obj interface{}) error {
    // 先绑定JSON
    if err := c.ShouldBindWith(obj, binding.JSON); err != nil {
        return err
    }
    // 再绑定Query
    if err := c.ShouldBindWith(obj, binding.Query); err != nil {
        return err
    }
    // 如有需要可额外添加 form、uri 等其他绑定器
    return nil
}

业务代码直接调用即可，和期望写法完全一致：

func Create(c *gin.Context) {
  var params Params
  if err := ShouldBindAll(c, &params); err == nil {
      log.Println("GOOD1")
      log.Println(params)
      // 业务逻辑
  } else {
      log.Println("ERROR1")
      log.Println(params)
      c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  }
}

注意事项 #

• 绑定顺序建议：优先绑定请求体（JSON/Form），再绑定Query/URI参数，避免请求体的有效值被Query的空值覆盖；如果需要Query参数优先级更高，调换两个绑定器的顺序即可
• 结构体标签对应规则：需要JSON读取的加json标签，需要Query读取的加form标签即可，Gin的Query绑定器默认读取form标签，不需要额外加query标签
• 可扩展性：如果需要支持更多参数来源（比如表单数据、URI路径参数），只需要在ShouldBindAll中添加对应绑定器即可，例如添加binding.URI支持路径参数绑定

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