如何在Laravel通用查询后拆分结果并避免条件污染？

问题根源 #

Laravel的QueryBuilder是引用类型的对象，如果直接用普通赋值（比如$cashQuery = $baseQuery）复制查询实例，两个变量指向的是同一个底层对象。这就导致你给其中一个实例添加的筛选条件，会同步影响另一个实例，最终出现现金查询意外包含银行ID条件的情况。

解决方法 #

要创建独立的查询实例，必须使用clone关键字复制基础查询，这样每个新实例都是完全独立的，添加的筛选条件不会互相干扰：

// 构建通用基础查询（含关联、公共筛选条件）
$baseQuery = SlipEntry::query()
    ->with(['yourRelatedModel']) // 关联模型
    ->where('status', 'active'); // 公共筛选条件

// 克隆基础查询，添加银行凭证ID筛选并执行
$bankQuery = clone $baseQuery;
$bankEntries = $bankQuery->where('bank_voucher_id', $targetBankId)->get();

// 重新克隆基础查询，添加现金凭证ID筛选并执行
$cashQuery = clone $baseQuery;
$cashEntries = $cashQuery->where('cash_voucher_id', $targetCashId)->get();

补充说明 #

• clone关键字会深度复制QueryBuilder的所有状态（包括已添加的关联、筛选条件、排序等），确保新实例和原实例完全独立。
• 避免直接使用$cashQuery = $baseQuery这种赋值方式，这只会传递对象引用，而非创建新实例。

内容的提问来源于stack exchange，提问作者Md. Amin Hossain