Laravel9队列Job中Spatie QueryBuilder过滤器不生效如何解决？

问题根源 #

你的代码存在两个核心问题导致过滤器未生效：

1. 未显式声明允许过滤的字段：Spatie QueryBuilder默认会忽略所有未通过allowedFilters声明的过滤器，这是框架内置的安全防护机制。
2. 请求的Filter结构错误：从日志输出看，$request->get('filter')返回的是嵌套数组['filter' => ['id' => 10]]，但QueryBuilder期望的filter字段值是直接的条件数组（如['id' => 10]）。

修复步骤 #

1. 修正请求的Filter结构 #

确保合并到请求中的filter是直接的条件数组，而非嵌套结构：

// 情况1：$this->filter本身就是['id' => 10]，直接合并
$request = app(QueryBuilderRequest::class)->merge(['filter' => $this->filter]);

// 情况2：$this->filter是嵌套结构（如['filter' => ['id' => 10]]），取内层数组
$request = app(QueryBuilderRequest::class)->merge(['filter' => $this->filter['filter']]);

2. 显式允许过滤字段 #

在QueryBuilder链中添加allowedFilters方法，声明允许过滤的字段（以下示例为精确匹配id）：

use Spatie\QueryBuilder\Filters\Filter;

return QueryBuilder::for(Customer::class, $request)
    ->allowedFilters([Filter::exact('id')]) // 允许对id字段进行精确匹配过滤
    ->where('id', '<', 20)
    ->orderByDesc('id')
    ->toBase();

3. 验证过滤器生效（可选） #

可以打印生成的SQL和绑定参数，确认过滤器是否正确应用：

$query = QueryBuilder::for(Customer::class, $request)
    ->allowedFilters([Filter::exact('id')])
    ->where('id', '<', 20);

Log::info('生成的SQL: ' . $query->toSql());
Log::info('绑定参数: ' . json_encode($query->getBindings()));

若过滤器生效，SQL中会包含and id = ?的条件，绑定参数里会有10。

额外说明 #

• 若需要模糊匹配等其他过滤逻辑，可替换为Filter::partial('id')或自定义过滤器类。
• toBase()方法仅返回Eloquent底层的QueryBuilder实例，不会影响过滤器的应用逻辑，只要过滤器在调用toBase()前已被处理。

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