在 Laravel 中，filter() 方法属于 Collection 而非 Query Builder，因此不能直接链式调用在 Order::withTrashed() 后；正确做法是先执行查询（如 paginate()）获取 Collection，再对其应用过滤逻辑。
在 laravel 中，`filter()` 方法属于 collection 而非 query builder，因此不能直接链式调用在 `order::withtrashed()` 后；正确做法是先执行查询（如 `paginate()`）获取 collection，再对其应用过滤逻辑。
然而，上述“先分页再过滤”的方案存在严重性能与逻辑缺陷：paginate(10) 会先从数据库取 10 条记录（可能完全不匹配筛选条件），再在内存中对这 10 条做 filter() —— 这不仅导致分页失效（总条数、上一页/下一页均错误），更使搜索形同虚设。
✅ 正确且推荐的解决方案：在 Query Builder 层实现过滤
你需要为 Order 模型显式添加 filter 作用域（Scope），使其支持链式调用：
// app/Models/Order.php
use App\Filters\Orders\OrderFilter;
class Order extends Model
{
// 定义全局作用域或本地作用域
public function scopeFilter($query, OrderFilter $filter)
{
return $filter->apply($query);
}
}同时，确保你的基类 QueryFilter 正确实现 apply() 方法（常见标准写法）：
// app/Filters/QueryFilter.php
<?php
namespace App\Filters;
use Illuminate\Database\Eloquent\Builder;
abstract class QueryFilter
{
protected $builder;
public function __construct(protected array $filters = [])
{
}
public function apply(Builder $builder): Builder
{
$this->builder = $builder;
foreach ($this->filters as $name => $value) {
if (method_exists($this, $name) && !is_null($value)) {
$this->$name($value);
}
}
return $builder;
}
}然后，在控制器中保持原始调用方式（无需修改）：
public function index(OrderFilter $filter): View
{
$items = Order::withTrashed()
->filter($filter) // ✅ 现在 filter() 是模型作用域，返回 Builder
->paginate(10);
return view($this->viewsPath . self::INDEX_ACTION, [
'items' => $items,
'perPage' => 10,
]);
}? 关键点说明：
-
scopeFilter是 Laravel 的约定命名（scope+ 方法名），会自动注册为查询作用域； -
filter($filter)现在作用于 Eloquent Builder，可真正下推到 SQL 层，支持高效分页、索引利用； -
OrderFilter中每个方法（如id(),name()）应只操作$this->builder（即传入的 Builder 实例），不返回值； - 若需支持空值跳过，可在
apply()中增加!is_null($value) && $value !== ''判断。
⚠️ 注意事项：
- 切勿在分页后对 Collection 使用
filter()做业务筛选——它破坏分页语义，且无法利用数据库索引； - 所有过滤字段建议添加数据库索引（如
name,address），提升 WHERE 查询性能； - 如需支持多字段模糊搜索（如
name OR address），应在OrderFilter中使用whereRaw()或orWhere()并注意分组括号。
通过作用域 + QueryFilter 组合模式，你既能保持控制器简洁，又能获得高性能、可维护、符合 Laravel 最佳实践的过滤能力。
