go-playground/validator：err.Translate仅传参时生效的问题排查

核心原因 #

go-playground/validator的翻译器（trans）是和特定的validator.Validate实例绑定的。如果工具包init里初始化了trans，但没把它关联到你实际用来做验证的Validate实例上，或者工具包和控制器用了不同的Validate实例，就会导致翻译失效，返回默认的原始错误信息。

常见错误场景及修复 #

1. 工具包与控制器使用不同的Validate实例 #

比如工具包代码里创建了自己的Validate实例并绑定翻译：

package validatorutil

import (
    "github.com/go-playground/locales/en"
    ut "github.com/go-playground/universal-translator"
    "github.com/go-playground/validator/v10"
    en_translations "github.com/go-playground/validator/v10/translations/en"
)

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

func init() {
    enLocale := en.New()
    uni := ut.New(enLocale, enLocale)
    trans, _ = uni.GetTranslator("en")
    validate = validator.New() // 工具包内创建独立实例
    en_translations.RegisterDefaultTranslations(validate, trans)
}

func TranslateErr(err error) map[string]string {
    errs := err.(validator.ValidationErrors)
    return errs.Translate(trans)
}

但控制器里却自己新建了Validate实例做验证：

// 控制器代码
validate := validator.New()
err := validate.Struct(req)
errMap := validatorutil.TranslateErr(err) // 错误来自控制器的实例，和工具包trans不绑定

这种情况下，错误是控制器实例生成的，工具包的trans只认自己绑定的实例，自然翻译失败。

修复方法：
统一复用同一个Validate实例。调整工具包提供封装好的验证+翻译函数，控制器直接调用即可：

// 工具包代码
package validatorutil

import (
    "github.com/go-playground/locales/en"
    ut "github.com/go-playground/universal-translator"
    "github.com/go-playground/validator/v10"
    en_translations "github.com/go-playground/validator/v10/translations/en"
)

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

func init() {
    enLocale := en.New()
    uni := ut.New(enLocale, enLocale)
    var err error
    trans, err = uni.GetTranslator("en")
    if err != nil {
        panic(err)
    }
    validate = validator.New()
    if err := en_translations.RegisterDefaultTranslations(validate, trans); err != nil {
        panic(err)
    }
    // 可选：映射结构体json标签为字段名，让翻译更友好
    validate.RegisterTagNameFunc(func(fld reflect.StructField) string {
        name := strings.SplitN(fld.Tag.Get("json"), ",", 2)[0]
        if name == "-" {
            return ""
        }
        return name
    })
}

// 控制器直接调用这个函数，无需自己处理验证和翻译
func ValidateAndTranslate(s interface{}) map[string]string {
    if err := validate.Struct(s); err != nil {
        if validationErrs, ok := err.(validator.ValidationErrors); ok {
            return validationErrs.Translate(trans)
        }
        return map[string]string{"error": err.Error()}
    }
    return nil
}

控制器调用示例：

errMap := validatorutil.ValidateAndTranslate(req)
if errMap != nil {
    // 处理错误响应
}

2. 翻译器未正确绑定到Validate实例 #

如果工具包init里只初始化了trans，但漏调用RegisterDefaultTranslations把trans和Validate实例绑定，或者绑定用错了实例，也会导致翻译失效。比如：

func init() {
    enLocale := en.New()
    uni := ut.New(enLocale, enLocale)
    trans, _ = uni.GetTranslator("en")
    validate = validator.New()
    // 漏了这行：en_translations.RegisterDefaultTranslations(validate, trans)
}

修复方法：
确保在init里执行RegisterDefaultTranslations，且传入当前的Validate实例和对应的trans。

3. 初始化顺序问题（少见） #

Go的init函数按包依赖顺序执行，如果工具包的init在控制器创建Validate实例之后执行，也会导致绑定不生效。可以在工具包init里加日志打印，确认启动时是否正常执行了初始化逻辑。

快速排查步骤 #

1. 确认产生错误的Validate实例，和工具包里绑定trans的实例是同一个。
2. 检查init函数是否调用了RegisterDefaultTranslations，参数是否正确。
3. 验证init函数是否在程序启动时正常执行。

内容的提问来源于stack exchange，提问作者Andi Fasaya Yaqhsya Ma'ruf