如何在Laravel Validator中为每个字段仅返回首个错误？

当你需要为前端接口返回每个字段仅含单个错误字符串的响应时，可以通过以下几种方式处理Laravel默认返回的数组格式错误信息：

方法一：直接转换错误集合 #

在验证失败的逻辑中，使用map方法遍历错误集合，提取每个字段的第一条错误信息，再转为数组：

$validator = Validator::make($request->all(),[
    'email'=>'required|email|unique:user',
    'first_name'=>'required|min:3',
]);

if ($validator->fails())
{
    // 提取每个字段的第一个错误，转为字符串格式的数组
    $formattedErrors = $validator->errors()->map(function($messages) {
        return $messages[0];
    })->toArray();
    
    $response = ['errors' => $formattedErrors];
    return $this->r(ResponseFactory::invalid_input_params($response));
}

用箭头函数可简化为：

$formattedErrors = $validator->errors()->map(fn($messages) => $messages[0])->toArray();

方法二：全局注册宏（提升复用性） #

如果多个接口都需要统一的错误格式，可在App\Providers\AppServiceProvider的boot方法中注册自定义宏，方便全局调用：

use Illuminate\Support\MessageBag;

public function boot()
{
    MessageBag::macro('toSingleErrorArray', function () {
        return $this->map(fn($messages) => $messages[0])->toArray();
    });
}

后续验证失败时直接调用宏即可：

$formattedErrors = $validator->errors()->toSingleErrorArray();

方法三：自定义FormRequest统一处理 #

如果使用FormRequest做验证，可重写failedValidation方法，统一处理错误输出格式：

use Illuminate\Contracts\Validation\Validator;
use Illuminate\Validation\ValidationException;

class YourFormRequest extends FormRequest
{
    // ... 其他规则和授权逻辑
    
    protected function failedValidation(Validator $validator)
    {
        $formattedErrors = $validator->errors()->map(fn($messages) => $messages[0])->toArray();
        
        // 若需自定义响应结构，替换为你的ResponseFactory逻辑
        throw ValidationException::withMessages($formattedErrors);
    }
}

以上方法均可生成你期望的响应格式：

{
    "code": 400,
    "kind": "invalid_input_params",
    "status": "error",
    "data": {
        "errors": {
            "email": "The email has already been taken.",
            "first_name": "The first name field is required."
        }
    }
}

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