Laravel GET查询参数需保留原始类型：布尔值验证失败

问题根源 #

HTTP GET请求的所有查询参数本质都是字符串类型，哪怕你在Postman中选择布尔类型发送，实际传递到后端的是"true"或"false"字符串。而Laravel的boolean验证规则仅接受原生布尔值true/false或整数1/0，因此字符串形式的布尔值会触发验证错误。

解决方案 #

1. 在请求类中统一做类型转换（推荐）

在GetActivitiesRequest类中重写prepareForValidation方法，自动将sortByLocation参数转换为布尔值：

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class GetActivitiesRequest extends FormRequest
{
    public function rules()
    {
        return [
            'sortByLocation' => 'nullable|boolean',
        ];
    }

    protected function prepareForValidation()
    {
        // 若参数存在，转换为布尔值
        if ($this->has('sortByLocation')) {
            $this->merge([
                'sortByLocation' => filter_var($this->sortByLocation, FILTER_VALIDATE_BOOLEAN),
            ]);
        }
    }
}

这个方法会在验证前执行，不管前端传的是"true"/"false"字符串还是1/0，都会被转换成对应的原生布尔值，完美适配boolean验证规则。

2. 修改验证规则兼容字符串布尔值

如果不想做类型转换，可以调整验证规则，允许字符串形式的布尔值通过，之后在业务逻辑中再转换类型：

public function rules()
{
    return [
        'sortByLocation' => 'nullable|in:true,false,1,0',
    ];
}

然后在控制器中处理参数：

public function index(GetActivitiesRequest $request)
{
    $sortByLocation = filter_var($request->sortByLocation, FILTER_VALIDATE_BOOLEAN);
    // 后续业务逻辑...
}

3. Postman中直接传递整数形式的布尔值

在Postman的Params面板中，将sortByLocation的值设为1（代表true）或0（代表false），Laravel的boolean验证规则会直接识别这些整数为布尔值，无需额外处理。

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