本文详解 Laravel 中如何通过方法链式调用将原本分步执行的 Eloquent 查询与分页操作（如 searchProduct() 和 paginate()）合并为一行简洁、高效、可读性强的代码，并强调链式调用的前提条件与常见陷阱。
本文详解 laravel 中如何通过方法链式调用将原本分步执行的 eloquent 查询与分页操作（如 `searchproduct()` 和 `paginate()`）合并为一行简洁、高效、可读性强的代码，并强调链式调用的前提条件与常见陷阱。
在 Laravel 开发中，提升代码简洁性与可维护性是重要实践目标。你当前的两行代码：
$product = $this->productService->searchProduct($request); $product = Product::paginate(9);
存在明显逻辑冲突：第一行已从服务层获取 $product（应为查询构造器或结果集），第二行却直接覆盖为静态调用 Product::paginate(9)，这不仅丢失了搜索逻辑，也违背数据流一致性。真正的合并不是简单拼接，而是确保前序方法返回可链式调用的 Builder 实例。
✅ 正确做法是让 searchProduct() 方法返回 Illuminate\Database\Eloquent\Builder 对象（即未执行的查询构造器），从而支持后续链式调用：
// ✅ 修改 ProductService::searchProduct() 方法（关键！）
public function searchProduct(SearchProductRequest $request)
{
$search = $request->search;
$min_price = $request->min_price;
$max_price = $request->max_price;
return Product::query() // 注意：返回 Builder，不加 get() 或 paginate()
->where('name', 'like', "%{$search}%")
->when($min_price, fn ($q) => $q->where('price', '>=', $min_price))
->when($max_price, fn ($q) => $q->where('price', 'orderBy('id');
}
? 注意：原问题中 ->where('price', [$min_price]) 语法错误（应为 >= 等比较操作），且 orWhere 与 where 混用易导致 SQL 逻辑错误（如价格范围失效）。此处已用 when() 辅助方法安全构建条件，并修正查询逻辑。
随后，在控制器中即可自然链式调用分页：
// ✅ 单行完成：构建查询 + 分页 $product = $this->productService->searchProduct($request)->paginate(9);
? 关键前提：searchProduct() 必须返回 Builder（而非 Collection 或数组），否则会抛出 Call to undefined method paginate() 错误。
? 在 Blade 视图中，务必使用 ->links() 渲染分页控件：
<div class="float-left mr-3 mb-1">
{{ $product->links() }}
</div>
⚠️ 常见误区提醒：
- ❌ 不要对已执行的查询（如 get()、first()、all() 返回的结果）调用 paginate()；
- ❌ 避免在服务方法中提前调用 paginate() —— 这会剥夺控制器对分页参数（如每页数量）的控制权；
- ✅ 推荐将「查询构建」与「执行/分页」职责分离：服务层专注构建 Builder，控制器决定如何执行（get() / paginate() / count() 等）。
通过这种设计，代码既保持单行简洁性，又兼顾灵活性、可测试性与 Laravel 最佳实践。
