Laravel默认验证消息失效求助：返回validation.required而非预期文本

问题描述 #

在Laravel项目中执行验证时，返回的错误消息是validation.required这类通用标识，而非预期的提示文本（如“邮箱字段不能为空”）。

使用的验证代码如下：

$request->validate([
    'email' => 'required|email',
    'password' => 'required',
]);

实际返回的响应内容：

Illuminate\Support\ViewErrorBag Object ( [bags:protected] => Array ( [default] => Illuminate\Support\MessageBag Object ( [messages:protected] => Array ( [email] => Array ( [0] => validation.required ) [password] => Array ( [0] => validation.required ) ) [format:protected] => :message ) ) )

预期错误消息应为[email] => Array ( [0] => 邮箱字段不能为空 )，但实际返回键名而非文本。此前验证逻辑正常，现在突然出现该问题，手动为每个规则配置消息（如下代码）过于繁琐，需要批量解决的方案：

$request->validate([
    'email' => 'required|email',
    'password' => 'required',
],[
    'email.required' => '邮箱不能为空',
]);

可能的原因及解决办法 #

1. 检查语言文件是否存在或损坏 #

Laravel默认验证消息存储在resources/lang/[语言标识]/validation.php文件中（比如中文对应resources/lang/zh-CN/validation.php，英文对应resources/lang/en/validation.php）。如果该文件缺失、被删除或内容被篡改，就会直接返回消息键名。

• 解决：从Laravel官方代码仓库复制对应语言的validation.php文件，放到项目的resources/lang/对应语言目录下。
• 同时确保config/app.php中的'locale'配置为正确的语言标识（如zh-CN）。

2. 清除配置缓存 #

如果之前执行过php artisan config:cache，可能导致语言配置被缓存，无法加载最新的语言文件。

• 执行以下命令清除缓存：

php artisan config:clear
php artisan cache:clear

3. 检查AppServiceProvider中的自定义验证器配置 #

如果在App\Providers\AppServiceProvider的boot方法中自定义了验证器实例或消息格式，可能覆盖了默认的翻译逻辑。

• 检查boot方法是否有类似以下代码，若有则注释或调整：

Validator::resolver(function ($translator, $data, $rules, $messages) {
    return new CustomValidator($translator, $data, $rules, $messages);
});

4. 测试翻译功能是否正常 #

在控制器中临时添加测试代码，确认翻译系统能否正常解析消息键：

dd(__('validation.required', ['attribute' => '邮箱']));

如果输出的还是validation.required，说明翻译系统未正常加载语言文件，回到步骤1和2重新排查。

5. 确认.env文件的语言配置 #

检查.env文件中的APP_LOCALE是否设置为正确的语言标识（如zh-CN或en），且该语言的资源文件存在。

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