Go Gin中Base64图片请求体验证失败，如何修改结构体？

核心问题：Binding标签的规则分隔符错误 #

你当前的结构体中，Logo字段的binding标签用了竖线|分隔多个Base64规则，但Gin依赖的go-playground/validator验证库要求多规则用逗号,分隔，竖线是无效写法，这是导致验证失败的直接原因。

修正后的结构体代码 #

type createCompanyRequestBody struct {
    Name string `json:"name" binding:"required"`
    Size string `json:"size" binding:"required"`
    Logo string `json:"logo" binding:"required,base64,base64url,base64rawurl"`
}

额外注意：处理Base64前缀（如果存在） #

如果你的请求中Logo字段带有data:image/png;base64,这类前缀，默认的base64验证规则会判定为无效。此时需要自定义验证函数来兼容这种情况：

1. 注册自定义验证器：

import (
    "github.com/gin-gonic/gin/binding"
    "github.com/go-playground/validator/v10"
    "strings"
)

func init() {
    if v, ok := binding.Validator.Engine().(*validator.Validate); ok {
        _ = v.RegisterValidation("base64_with_prefix", func(fl validator.FieldLevel) bool {
            str := fl.Field().String()
            // 移除可能的data URI前缀
            if strings.HasPrefix(str, "data:") {
                parts := strings.Split(str, ",")
                if len(parts) != 2 {
                    return false
                }
                str = parts[1]
            }
            // 验证处理后的字符串是否符合任意一种Base64格式
            _, err := validator.New().Var(str, "base64,base64url,base64rawurl")
            return err == nil
        })
    }
}

2. 修改结构体标签使用自定义验证规则：

type createCompanyRequestBody struct {
    Name string `json:"name" binding:"required"`
    Size string `json:"size" binding:"required"`
    Logo string `json:"logo" binding:"required,base64_with_prefix"`
}

验证错误排查技巧 #

可以打印具体的错误信息来定位问题，而不是直接返回400：

var body createCompanyRequestBody
if err := ctx.ShouldBindJSON(&body); err != nil {
    ctx.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
    return
}

这样能看到验证库返回的具体错误提示，比如是格式不匹配还是前缀问题。

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