Gin框架中int类型字段传字符串返回500，如何改为400错误？

问题原因 #

当给int类型字段（比如price）传入字符串时，ShouldBindJSON会先触发JSON反序列化错误，这个错误不属于validator.ValidationErrors类型。你之前的代码直接强制将err转换为validator.ValidationErrors，会引发panic，导致接口返回500内部错误；而字符串字段的错误属于校验器规则层面的错误，能正常转换，所以原有逻辑只覆盖了校验规则错误，没处理绑定阶段的类型不匹配问题。

修复方案 #

需要先判断错误类型，分别处理校验规则错误和绑定错误：

• 优先检查错误是否为validator.ValidationErrors，处理字段不符合校验规则的情况
• 否则处理绑定错误（类型不匹配、JSON格式错误等）
• 所有参数相关错误统一返回400 Bad Request状态码
• 同时修复Service返回错误后未终止函数的问题，避免重复响应

修改后的代码 #

func (controller *BookControllerImpl) Create(ctx *gin.Context) {
    var bookRequest web.BookRequest

    err := ctx.ShouldBindJSON(&bookRequest)
    if err != nil {
        var errorRequest []string

        // 处理校验器规则错误
        if validationErrs, ok := err.(validator.ValidationErrors); ok {
            for _, e := range validationErrs {
                errorMessage := fmt.Sprintf("字段 %s 不符合规则 %s", e.Field(), e.ActualTag())
                errorRequest = append(errorRequest, errorMessage)
            }
        } else {
            // 处理绑定错误（类型不匹配、JSON格式错误等）
            errorRequest = append(errorRequest, "请求参数格式错误："+err.Error())
        }

        ctx.JSON(http.StatusBadRequest, web.WebResponse{
            Code:   http.StatusBadRequest,
            Status: "BAD REQUEST",
            Data:   errorRequest,
        })
        return
    }

    book, err := controller.BookService.Create(bookRequest)
    if err != nil {
        ctx.JSON(http.StatusBadRequest, web.WebResponse{
            Code:   http.StatusBadRequest,
            Status: "BAD REQUEST",
            Data:   err.Error(),
        })
        return // 补上return，避免执行后续的OK响应
    }

    ctx.JSON(http.StatusOK, web.WebResponse{
        Code:   200,
        Status: "Ok",
        Data:   book,
    })
}

额外说明 #

• 结构体中的numeric标签对int类型字段是冗余的，因为int本身就是数值类型，可以去掉，减少不必要的校验逻辑
• 如果需要更精细化的绑定错误提示，可以解析json.Unmarshal的错误信息，提取具体的字段和类型不匹配细节，上述代码已满足返回400错误的核心需求

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