Go Gin框架能否通过匿名结构体实现参数验证？

可以通过函数内定义的结构体（类似匿名结构体的用法）实现Gin的参数验证，但你当前的代码存在关键问题，无法完成预期的验证逻辑。

问题分析 #

你当前的实现中，GetValidation返回的是函数内定义的结构体实例，且类型被装箱为any。当你在CreatePayment中调用context.ShouldBindBodyWith(&input, binding.JSON)时，实际传递的是*any类型的指针，而非结构体指针。Gin的绑定器依赖反射识别结构体字段的binding标签，但*any类型无法让反射获取到内部结构体的字段和标签信息，因此验证会失效。

修正方案 #

要让验证生效，核心是确保传递给ShouldBindBodyWith的是结构体指针，且反射能正确识别结构体的字段和标签。

方案1：返回函数内定义结构体的指针

调整驱动包的GetValidation，返回结构体指针而非实例：

// driver package
func GetValidation() any {
    type Validator struct {
        Key      string `json:"api_key" binding:"required"`
        Password string `json:"api_password" binding:"required"`
        Currency string `json:"api_currency" binding:"required,coinremitterCurrency"`
    }
    return &Validator{} // 返回结构体指针
}

上层调用时直接传递该指针，无需再取地址：

func CreatePayment(context *gin.Context) {
    input := paymentpackage.GetValidation()

    if err := context.ShouldBindBodyWith(input, binding.JSON); err != nil {
        context.JSON(http.StatusUnprocessableEntity, gin.H{"success": false, "errors": err.Error()})
        return
    }

    // 如需使用字段，可通过类型断言（注意：函数内定义的结构体无法跨包直接引用，需匹配结构体字段定义）
    validator, ok := input.(*struct {
        Key      string
        Password string
        Currency string
    })
    if ok {
        fmt.Println("API Key:", validator.Key)
    }
}

方案2：使用包级别结构体（更推荐）

将验证结构体定义在驱动包的包级别，方便类型断言和后续字段操作：

// driver package
// 包级别定义验证结构体
type PaymentValidator struct {
    Key      string `json:"api_key" binding:"required"`
    Password string `json:"api_password" binding:"required"`
    Currency string `json:"api_currency" binding:"required,coinremitterCurrency"`
}

func GetValidation() any {
    return &PaymentValidator{}
}

上层调用时直接断言到具体类型：

func CreatePayment(context *gin.Context) {
    input := paymentpackage.GetValidation()

    if err := context.ShouldBindBodyWith(input, binding.JSON); err != nil {
        context.JSON(http.StatusUnprocessableEntity, gin.H{"success": false, "errors": err.Error()})
        return
    }

    // 类型断言到具体结构体，直接操作字段
    if validator, ok := input.(*driverpackage.PaymentValidator); ok {
        fmt.Println("验证通过的API Key:", validator.Key)
    }
}

总结 #

这种模式完全可以实现通用参数验证：每个驱动定义自己的验证结构体，通过统一的GetValidation接口返回指针，上层通用函数调用Gin的绑定方法完成验证，避免为每个驱动重复编写验证逻辑。

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