使用PATCH请求更新Restful API单字段时验证失败求助

问题描述 #

构建Restful API时，期望通过Postman发送PATCH请求仅更新单个字段，其余字段自动填充现有数据，但目前无法通过必填项验证。

更新代码 #

public function update(UpdatePostRequest $request, string $id)
{
    $post = Post::findOrFail($id);

    $post->update([
        'name' => $request->filled('name') ? $request->name : $post->name,
        'body' => $request->filled('body') ? $request->body : $post->body,
        'email' => $request->filled('email') ? $request->email : $post->email,
        'phone' => $request->phone ? $request->phone : $post->phone,
    ]);

    $postResource = new PostResource($post);

    return $this->sentSuccessResponse($postResource, 'success', Response::HTTP_OK);
}

验证代码 #

public function rules(): array
{
    return [
        'name' => 'required',
        'body' => 'required',
        'email' => 'required|email',
        'phone' => 'required|size:10'
    ];
}

protected function failedValidation(Validator $validator)
{
    $response = new Response([
        'errors' => $validator->errors(),
    ], Response::HTTP_UNPROCESSABLE_ENTITY);
    throw (new ValidationException($validator, $response));
}

问题根源 #

验证逻辑在控制器方法执行之前就会触发，你在update方法里用现有数据填充未传字段的操作根本没机会执行——因为PATCH请求只传了单个字段，其他必填字段未出现在请求中，直接触发了验证失败。

解决方法 #

调整验证规则，让字段仅在请求中存在时才执行必填验证，Laravel的sometimes规则正好适配这种场景：

方案1：直接使用sometimes规则 #

修改验证类的rules方法：

public function rules(): array
{
    return [
        'name' => 'sometimes|required',
        'body' => 'sometimes|required',
        'email' => 'sometimes|required|email',
        'phone' => 'sometimes|required|size:10'
    ];
}

sometimes规则的作用是：只有当字段出现在请求数据中时，才会应用后续的验证规则。这样PATCH请求只传单个字段时，其他字段不会触发验证，控制器里的填充逻辑就能正常执行。

方案2：根据请求方法动态调整规则 #

如果需要区分POST（新增）和PATCH（更新）场景，新增时要求全字段必填，更新时仅验证传入的字段，可以这样写：

public function rules(): array
{
    $baseRules = [
        'name' => 'required',
        'body' => 'required',
        'email' => 'required|email',
        'phone' => 'required|size:10'
    ];

    // 若为PATCH请求，将所有required规则改为sometimes|required
    if ($this->isMethod('patch')) {
        foreach ($baseRules as $field => &$rules) {
            $rules = preg_replace('/^required/', 'sometimes|required', $rules);
        }
    }

    return $baseRules;
}

额外提示 #

确保你的Post模型已经设置了$fillable属性，允许批量更新这些字段，避免批量赋值异常：

class Post extends Model
{
    protected $fillable = ['name', 'body', 'email', 'phone'];
}

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