Laravel 8 API调用返回验证错误仅显示键名无完整提示如何解决

问题原因 #

Laravel返回的validation.email、validation.min.string属于翻译索引键，未被替换为实际错误提示文本，通常是语言配置不匹配或语言包缺失导致的。

解决方案 #

方案1：适配系统自带翻译机制 #

• 第一步：配置请求头
  打开Postman的请求Header配置，添加Accept-Language参数，需要英文提示填en，需要中文提示填zh-CN，Laravel会优先根据该参数匹配对应语言的提示文本。
• 第二步：安装对应语言包（仅非英文需要）
  Laravel 8默认仅自带英文语言包，如需中文提示先执行安装命令：

  composer require overtrue/laravel-lang
  

  安装完成后发布中文语言包：

  php artisan lang:publish zh-CN
  

• 第三步：修改默认语言配置（可选）
  打开config/app.php文件，修改locale参数值为默认语言，比如中文设置为：

  'locale' => 'zh-CN',
  

  配置后即使不传Accept-Language请求头也会默认返回对应语言的提示。

方案2：自定义错误提示（无需依赖语言包） #

直接在控制器的验证方法内定义错误消息，修改你的代码如下：

public function __invoke(Request $request)
{
    // 自定义错误提示文本
    $errorMessages = [
        'email.required' => '邮箱不能为空',
        'email.email' => '请输入合法的邮箱地址',
        'email.max' => '邮箱长度不能超过255个字符',
        'password.required' => '密码不能为空',
        'password.min' => '密码长度不能少于8位'
    ];

    $credentials = $request->validate([
        'email' => 'required|email|max:255',
        'password' => 'required|min:8'
    ], $errorMessages);

    $credentials['status'] = true;

    if (Auth::attempt($credentials)) {
        return response()->json('login success!');
    } else {
        return response()->json('login failure!');
    }
}

配置完成后触发验证错误即可返回完整的自定义提示文本。

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