在 laravel 中，eloquent 查询构建器是链式调用且可变的对象，直接复用同一实例进行多次 where() 会导致原始查询被持续修改；需通过 clone 创建独立副本，确保各查询逻辑互不干扰。
在 laravel 中，eloquent 查询构建器是链式调用且可变的对象，直接复用同一实例进行多次 where() 会导致原始查询被持续修改；需通过 clone 创建独立副本，确保各查询逻辑互不干扰。
Eloquent 的查询构建器（如 Order::query() 或 (new Order)->query()）本质上是一个可变对象（mutable object），其内部维护着查询条件、排序、分页等状态。当你执行：
$orders = (new Order)->where('placed_by', '=', 'client');此时 $orders 是一个尚未执行的查询构建器实例。而后续调用：
$totalPrice100 = $orders->where('total_price', '=', '100');
$totalPrice10 = $orders->where('total_price', '=', '10');⚠️ 问题就在这里：$orders->where(...) 并非返回全新查询，而是原地修改 $orders 并返回自身引用（即 Fluent Interface 设计），因此两次调用后，$orders 内部已累积两个 WHERE 条件（placed_by = 'client' AND total_price = '100' AND total_price = '10'），这显然不符合预期，且 $totalPrice100 和 $totalPrice10 实际指向同一个（已被污染的）构建器。
✅ 正确做法是：对原始构建器使用 clone 创建独立副本。Laravel 的查询构建器实现了 PHP 的 __clone() 方法，能安全复制查询状态（包括绑定参数、连接配置、where 子句等）：
// 基础查询（不执行）
$baseQuery = Order::where('placed_by', 'client');
// 克隆出两个完全独立的查询实例
$query100 = clone $baseQuery;
$query10 = clone $baseQuery;
// 各自添加不同条件，互不影响
$result100 = $query100->where('total_price', 100)->get();
$result10 = $query10->where('total_price', 10)->get();
// 验证：原始 $baseQuery 未被修改
dd($baseQuery->toSql()); // "select * from `orders` where `placed_by` = ?"? 小贴士：
- clone 是最轻量、语义最清晰的解决方案，优于重复书写基础条件或使用闭包封装；
- 不要误用 clone $orders->get() —— get() 返回的是集合（Collection），克隆它无意义；
- 若需动态构建多个变体查询（如按价格区间、状态等组合），推荐封装为方法并统一使用 clone 起始；
- 注意：clone 不会复制模型事件监听器或自定义查询作用域中的闭包状态，但对标准 Eloquent 查询条件完全可靠。
总结：Eloquent 查询构建器不是“不可变值”，而是“可变对象”。理解其设计本质，并主动使用 clone，是编写可维护、可预测查询逻辑的关键实践。
