如何将go-playground/validator的ValidateMap错误转为可读信息？

当使用ValidateMap验证map类型数据时，返回的error接口底层实际是validator.ValidationErrors类型，只需通过类型断言转换，就能复用翻译器生成用户可读的错误信息。以下是具体实现方案：

1. 初始化验证器与翻译器 #

先完成基础的验证器和翻译器初始化（以中文翻译为例）：

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

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

func init() {
    // 初始化中文本地化实例
    zhLocale := zh.New()
    uni := ut.New(zhLocale, zhLocale)
    var err error
    trans, err = uni.GetTranslator("zh")
    if err != nil {
        panic(err)
    }

    // 初始化验证器并注册中文翻译规则
    validate = validator.New()
    if err := zhTrans.RegisterDefaultTranslations(validate, trans); err != nil {
        panic(err)
    }
}

2. 实现Map验证与错误翻译 #

编写验证函数，通过类型断言将错误转换为ValidationErrors，再逐个翻译：

func ValidateMapWithTranslation(data map[string]interface{}, rules map[string]string) map[string]string {
    // 传入待验证的map和对应的验证规则
    err := validate.ValidateMap(data, rules)
    if err == nil {
        return nil
    }

    // 类型断言为ValidationErrors类型
    validationErrs, ok := err.(validator.ValidationErrors)
    if !ok {
        return map[string]string{"global": "发生未知验证错误"}
    }

    // 遍历错误并生成可读信息
    errMsgMap := make(map[string]string)
    for _, e := range validationErrs {
        // e.Field()对应map中的键名，e.Translate(trans)生成翻译后的错误信息
        errMsgMap[e.Field()] = e.Translate(trans)
    }
    return errMsgMap
}

3. 使用示例 #

调用验证函数时传入待验证的map和规则：

func main() {
    userData := map[string]interface{}{
        "email": "invalid-email",
        "age":   17,
    }

    validationRules := map[string]string{
        "email": "required,email",
        "age":   "required,min=18",
    }

    errMessages := ValidateMapWithTranslation(userData, validationRules)
    // 输出：map[age:年龄必须大于或等于18 email:email必须是一个有效的邮箱地址]
    fmt.Println(errMessages)
}

关键说明 #

• ValidateMap的第二个参数是必填的规则映射，键对应map中的字段名，值为验证标签（格式和结构体验证标签完全一致）。
• 类型断言是核心：只有将返回的error转换为validator.ValidationErrors，才能调用Translate方法使用翻译器。
• 若需要自定义错误信息，可通过RegisterTranslation方法为特定标签注册自定义翻译，逻辑和结构体验证的自定义方式完全相同。

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