ShouldBind* 与 MustBind* 区别

结论先行

两者绑定逻辑相同：按请求 Content-Type / 方法自动选择 binding（JSON、XML、Form、MultipartForm…）把请求体解析进结构体。区别只在错误处理策略：ShouldBind* 返回 error 交给你处理（推荐）；MustBind* 出错时自动中止 handler 链并返回 400。

对比表

维度	ShouldBind*	MustBind*
绑定能力	相同（ShouldBind/ShouldBindJSON/ShouldBindQuery/ShouldBindXML…）	相同（MustBindWith/MustBindJSON 等）
失败时的响应	不写任何响应，只返回 error	自动返回 400 并中止后续 handler
能否自定义错误体	能，自己判断 err 后自由返回	不能，走框架固定逻辑
生产推荐度	推荐：统一错误响应、可加日志与追踪	原型/内部接口可用
补充方法	ShouldBindQuery 只绑查询串，ShouldBind 自动选型	MustBindWith(obj, binding.X) 显式指定

代码示例

type LoginReq struct {
    Name string `json:"name" binding:"required"`
    Pass string `json:"pass" binding:"required"`
}

// 推荐：手动处理错误，统一响应体
r.POST("/login", func(c *gin.Context) {
    var req LoginReq
    if err := c.ShouldBindJSON(&req); err != nil {
        c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
        return
    }
    // 业务逻辑...
})

// 快速写法：出错自动 400（无自定义响应体）
r.POST("/login2", func(c *gin.Context) {
    var req LoginReq
    _ = c.MustBindJSON(&req) // 失败已 400 + Abort
    // 走到这说明绑定成功
})

实现细节与坑

• MustBindWith 出错走的是 AbortWithError(http.StatusBadRequest, err) 一类逻辑（是否带响应体随版本实现而定，以官方文档与源码为准）。
• ShouldBind 自动选型规则：GET 等无 body 方法走 Form 绑定；否则按 Content-Type 选择。多字段查询参数建议显式 ShouldBindQuery。
• 绑定成功 ≠ 字段有效：零值字段照样绑定成功，必填约束要靠 binding tag（见下一章）。
• 忘了检查 ShouldBind 的返回值 = 绑定失败静默，这是高频线上 bug（见第 25 章）。

常见追问 / 记忆点

• 追问：为什么生产代码推荐 ShouldBind？答：错误体、状态码、日志、监控都要统一出口，MustBind 帮你写死的 400 没有业务语义。
• 记忆点：Should = 自己处理错误；Must = 自动 400 短路；绑定只是“解析”，校验靠 tag。