Gin 的 BindJSON 要求传入指向结构体变量的指针（即 &structVar），而非指向结构体指针的指针（即 &structPtr）；若误传二级指针，校验将被跳过，导致 binding:"required" 失效。
gin 的 `bindjson` 要求传入**指向结构体变量的指针**（即 `&structvar`），而非指向结构体指针的指针（即 `&structptr`）；若误传二级指针，校验将被跳过，导致 `binding:"required"` 失效。
在 Gin 框架中，JSON 绑定与结构体验证高度依赖 binding 包的 ValidateStruct 接口实现。该接口明确规定：仅当传入参数是结构体本身或指向结构体的一级指针时，才会执行字段校验；若传入的是指向指针的指针（如 `foos），则直接跳过验证，返回nil` 错误**——这正是问题的根本原因。
你最初的写法：
var json *foos
if err := c.BindJSON(&json); err != nil { /* ... */ }此时 &json 的类型是 **foos（指向 *foos 的指针），属于“指针的指针”。Gin 的校验器检测到非结构体/非一级指针类型后，按规范静默跳过验证，因此即使 JSON 缺失 foo 字段（如 {"bar":"bar bar"}），err 仍为 nil，且 json 被初始化为 nil，后续使用可能引发 panic。
✅ 正确写法应始终传递结构体变量的地址：
func sendFoo(c *gin.Context) {
var json foos // 值类型变量（非指针）
if err := c.BindJSON(&json); err != nil {
c.JSON(400, gin.H{"error": "invalid request: " + err.Error()})
return
}
// ✅ 此时 json.foo 已经通过 required 校验，可安全使用
c.JSON(200, gin.H{"received": json.Foo})
}⚠️ 补充说明与最佳实践：
-
不要对结构体指针取地址：
*foos是指针类型，&json（其中json *foos）得到的是**foos，违反绑定契约； -
结构体定义建议导出字段：确保
Foo首字母大写（已满足），否则 JSON 解析和反射校验均不可见； -
推荐显式错误处理：使用
c.AbortWithError(400, err)或c.JSON返回结构化错误，便于前端调试； -
进阶验证可结合
ShouldBind：若需区分解析失败与校验失败，可用c.ShouldBindJSON(&json)并手动检查errors.Is(err, binding.ErrInvalidJSON)等。
总结：Gin 的绑定机制严格遵循“值或一级指针”约定。牢记 BindJSON 的参数必须是 &T{}（T 为结构体类型），而非 &(*T) —— 这一细节虽小，却直接影响数据安全与接口健壮性。
