如何在Golang validator包中重命名错误返回的字段名？

有两种常用方法可以实现验证错误时替换字段名：

方法一：自定义结构体标签+反射解析 #

给结构体字段添加自定义标签（比如label）存储替换后的名称，处理错误时通过反射读取标签值：

1. 修改结构体，添加label标签：

type SignInUserData struct {
  Email    string `json:"email" validate:"required" label:"Email Address"`
  Password string `json:"password" validate:"required" label:"Secret"`
}

2. 处理验证错误时解析标签：

import "reflect"

// 假设err是验证返回的错误
validationErrors := err.(validator.ValidationErrors)

for _, fieldError := range validationErrors {
    // 通过反射获取结构体字段信息
    field, ok := reflect.TypeOf(SignInUserData{}).FieldByName(fieldError.Field())
    if ok {
        // 读取label标签内容
        customName := field.Tag.Get("label")
        if customName != "" {
            fmt.Println(customName)
            continue
        }
    }
    // 没有自定义标签时，使用原字段名
    fmt.Println(fieldError.Field())
}

方法二：使用validator内置的字段名替换函数 #

通过RegisterTagNameFunc注册全局字段名映射函数，让validator直接返回替换后的名称，无需手动解析：

1. 初始化validator时注册替换函数：

import (
    "github.com/go-playground/validator/v10"
    "reflect"
)

var validate *validator.Validate

func init() {
    validate = validator.New()
    // 注册字段名替换逻辑：优先取label标签，其次取json标签，最后用原字段名
    validate.RegisterTagNameFunc(func(fld reflect.StructField) string {
        if label := fld.Tag.Get("label"); label != "" {
            return label
        }
        if jsonTag := fld.Tag.Get("json"); jsonTag != "" {
            return jsonTag
        }
        return fld.Name
    })
}

2. 处理错误时直接获取替换后的名称：

validationErrors := err.(validator.ValidationErrors)

for _, fieldError := range validationErrors {
    // 这里fieldError.Field()会直接返回"Email Address"或"Secret"
    fmt.Println(fieldError.Field())
}

第二种方法更高效，适合全局统一处理字段名替换的场景；第一种方法更灵活，适合局部自定义处理的需求。

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