如何自定义验证错误消息并实现多语言版本？需保留结果结构

嗨，这完全可行的！而且刚好能满足你保留字段名结构来在客户端展示的需求，下面我给你拆解具体的实现思路和步骤：

首先，不管你用的是后端框架还是自己手写验证逻辑，都可以为每个字段的每类验证规则指定自定义消息，同时保留以字段名为键的错误结构。举个后端框架（比如Laravel）的示例：

// 定义验证规则
$rules = [
    'email' => 'required|email',
    'password' => 'required|min:8'
];

// 自定义错误消息，关联字段和规则
$customMessages = [
    'email.required' => '邮箱地址不能为空',
    'email.email' => '请输入有效的邮箱格式',
    'password.required' => '密码不能为空',
    'password.min' => '密码长度不能少于8位'
];

// 执行验证
$validator = Validator::make($request->all(), $rules, $customMessages);

if ($validator->fails()) {
    // 返回和你当前结构一致的错误响应，键为字段名，值为对应错误消息
    return response()->json([
        'errors' => $validator->errors()->toArray()
    ], 422);
}

如果是前端自定义验证，思路也是一样：验证失败时，把对应字段的自定义消息存入以字段名为键的对象中即可。

要支持多语言，核心是把错误消息按语言分类存储，然后根据当前请求的语言环境加载对应消息，同时依然保留字段名结构：

1. 准备多语言消息文件 #

为每种语言创建独立的消息配置文件，比如：

• 英文消息文件（en/validation.php）：

return [
    // 自定义字段名的友好显示（可选）
    'attributes' => [
        'email' => 'Email Address',
        'password' => 'Password'
    ],
    // 验证规则对应的消息
    'required' => 'The :attribute field is required.',
    'email' => 'The :attribute must be a valid email address.',
    'min' => [
        'string' => 'The :attribute must be at least :min characters.'
    ]
];

• 中文消息文件（zh-CN/validation.php）：

return [
    'attributes' => [
        'email' => '邮箱地址',
        'password' => '密码'
    ],
    'required' => ':attribute 不能为空',
    'email' => ':attribute 格式无效',
    'min' => [
        'string' => ':attribute 长度不能少于 :min 位'
    ]
];

这里的:attribute会自动替换成字段名（或者你定义的友好字段名），非常灵活。

2. 根据请求切换语言环境 #

可以通过请求头（比如Accept-Language）、URL参数或者用户设置来切换语言，以Laravel为例：

// 从请求头获取语言偏好，默认用中文
$lang = $request->header('Accept-Language', 'zh-CN');
// 设置应用语言
App::setLocale($lang);

3. 自动加载对应语言的消息 #

验证时不需要再手动传自定义消息，框架会自动加载当前语言环境下的消息文件，返回的错误结构依然是字段名作为键的格式，完全符合你客户端展示的需求。

如果是完全自定义的验证逻辑（不用框架），也可以这么做：

1. 用JSON文件存储多语言消息，比如en.json和zh-CN.json：

// zh-CN.json
{
    "errors": {
        "email": {
            "required": "邮箱地址不能为空",
            "invalid": "请输入有效的邮箱格式"
        },
        "password": {
            "required": "密码不能为空",
            "min": "密码长度不能少于8位"
        }
    }
}

2. 验证时根据当前语言加载对应文件，组装错误结构：

function validateForm(data, lang = 'zh-CN') {
    // 加载对应语言的消息
    const langMessages = require(`./lang/${lang}.json`).errors;
    const errors = {};

    // 邮箱验证
    if (!data.email) {
        errors.email = [langMessages.email.required];
    } else if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(data.email)) {
        errors.email = [langMessages.email.invalid];
    }

    // 密码验证
    if (!data.password) {
        errors.password = [langMessages.password.required];
    } else if (data.password.length < 8) {
        errors.password = [langMessages.password.min];
    }

    // 返回错误结构，和你当前的一致
    return Object.keys(errors).length ? { errors } : null;
}

这样既实现了自定义错误消息，又支持多语言切换，还完美保留了你需要的字段名结构，完全符合你的需求～

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