Go go-playground/validator/v10：自定义校验器如何注册错误消息

一、完整实现自定义校验器+错误消息配置 #

下面是可直接运行的代码示例，包含自定义stringMinLength校验器、错误消息绑定以及使用流程：

import (
    "fmt"
    "strconv"
    "github.com/go-playground/locales/zh"
    ut "github.com/go-playground/universal-translator"
    "github.com/go-playground/validator/v10"
    zhTranslations "github.com/go-playground/validator/v10/translations/zh"
)

var (
    validate *validator.Validate
    trans    ut.Translator
)

func init() {
    // 初始化校验器实例
    validate = validator.New()

    // 1. 注册自定义校验器
    err := validate.RegisterValidation("stringMinLength", func(fl validator.FieldLevel) bool {
        // 解析校验规则中的参数（如`stringMinLength=5`中的5）
        minLen, err := strconv.Atoi(fl.Param())
        if err != nil {
            return false
        }
        // 校验字段值的长度是否达标
        return len(fl.Field().String()) >= minLen
    })
    if err != nil {
        panic(fmt.Sprintf("注册校验器失败: %v", err))
    }

    // 2. 初始化中文翻译器
    zhLocale := zh.New()
    uni := ut.New(zhLocale, zhLocale)
    trans, _ = uni.GetTranslator("zh")

    // 3. 注册内置校验器的中文翻译（可选，但建议做，统一错误风格）
    err = zhTranslations.RegisterDefaultTranslations(validate, trans)
    if err != nil {
        panic(fmt.Sprintf("注册内置翻译失败: %v", err))
    }

    // 4. 绑定自定义校验器的错误消息
    err = validate.RegisterTranslation("stringMinLength", trans,
        func(ut ut.Translator) error {
            // 设置消息模板：{0}替换为校验参数（最小长度），{1}替换为字段名
            return ut.Add("stringMinLength", "{1}长度不能小于{0}个字符", true)
        },
        func(ut ut.Translator, fe validator.FieldError) string {
            // 替换模板中的占位符，生成最终错误消息
            msg, err := ut.T("stringMinLength", fe.Param(), fe.Field())
            if err != nil {
                return fe.Error()
            }
            return msg
        },
    )
    if err != nil {
        panic(fmt.Sprintf("注册自定义翻译失败: %v", err))
    }
}

// 使用示例
type User struct {
    Username string `validate:"stringMinLength=5"`
}

func main() {
    user := User{Username: "abc"}
    err := validate.Struct(user)
    if err != nil {
        // 遍历错误并输出翻译后的消息
        for _, e := range err.(validator.ValidationErrors) {
            fmt.Println(e.Translate(trans))
        }
    }
}

运行这段代码会输出：Username长度不能小于5个字符

二、翻译器的核心作用 #

你之前困惑的翻译器，本质是错误消息的映射与渲染工具，核心价值有三点：

1. 统一消息管理：把所有校验规则（内置+自定义）的错误消息集中配置，避免代码中硬编码零散的提示文本。
2. 动态参数替换：支持通过占位符（如{0}、{1}）动态插入校验参数、字段名等变量，生成精准的错误提示。
3. 多语言适配：只需切换翻译器的语言实例（比如换成英文en），就能一键生成对应语言的错误消息，无需修改校验逻辑。

另外，翻译器还能自动处理内置校验器的错误消息格式，让自定义校验器的错误提示和内置规则风格统一，提升代码的可维护性。

三、常见注意事项 #

• 自定义校验器的参数解析要做好错误处理（比如示例中用strconv.Atoi解析长度参数，失败时直接返回false触发校验失败）。
• 注册翻译时，ut.Add方法的第三个参数true表示覆盖已存在的同名消息，避免冲突。
• 必须先初始化翻译器，再注册自定义校验器的消息绑定，否则会报错。

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