Laravel 查询采购待付款清单：正确关联与聚合计算实战指南-php教程-PHP中文网

Laravel 查询采购待付款清单：正确关联与聚合计算实战指南

本文详解如何在 laravel 中使用 eloquent 或 query builder 正确查询采购待付款清单，解决因子查询未命名导致字段不可读、重复数据及逻辑错误等问题，并提供健壮、可维护的 sql 构建方案。

本文详解如何在 laravel 中使用 eloquent 或 query builder 正确查询采购待付款清单，解决因子查询未命名导致字段不可读、重复数据及逻辑错误等问题，并提供健壮、可维护的 sql 构建方案。

在构建采购系统时，常需统计每笔采购单（purchases）的总金额、已付金额与剩余待付金额（即 due_amount）。但直接在 join 查询中嵌套子查询却未指定别名，会导致 Laravel 返回的字段名非法（如带换行和空格的长字符串），不仅难以访问，还可能引发 JSON 序列化或前端解析异常——这正是提问者遇到的核心问题。

✅ 正确写法：为子查询显式指定别名

原始代码中：

DB::raw("(SELECT SUM(purchase_transactions.paid_amount) FROM purchase_transactions 
WHERE purchase_transactions.purchases_id = purchases.purchases_id)")

该表达式无别名，Laravel 将其原始 SQL 片段作为键名（含换行与空格），造成结果中出现不可用的字段键，例如：

{"(SELECT SUM(...)": 15}

修复方式：添加 as sum_paid 别名：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

DB::table('purchase_transactions')
    ->join('purchases', 'purchases.purchase_id', '=', 'purchase_transactions.purchases_id') // 注意字段名一致性（见下文）
    ->select(
        'purchases.purchase_id',
        'purchases.bill as total_amount',
        DB::raw('(SELECT COALESCE(SUM(pt.paid_amount), 0) FROM purchase_transactions AS pt WHERE pt.purchases_id = purchases.purchase_id) as paid_amount'),
        DB::raw('purchases.bill - (SELECT COALESCE(SUM(pt.paid_amount), 0) FROM purchase_transactions AS pt WHERE pt.purchases_id = purchases.purchase_id) as due_amount')
    )
    ->groupBy('purchases.purchase_id', 'purchases.bill')
    ->get();

? 关键改进点：

使用 as paid_amount 显式命名聚合字段，确保结果中可直接通过 $row->paid_amount 访问；

添加 COALESCE(..., 0) 避免 SUM() 在无记录时返回 null；

使用 GROUP BY 消除因一对多关联导致的重复行（purchase_transactions 多条记录对应同一 purchase_id）；

修正表关联字段：根据示例数据，purchases 表主键为 id，但业务标识为 purchase_id（非 purchases_id），而 purchase_transactions.purchases_id 实际应关联 purchases.purchase_id —— 务必核对真实字段命名，避免 join 条件失效。

? 推荐进阶方案：使用 Eloquent 关系 + withSum（Laravel 9+）

若已定义模型关系，更简洁、可读性更强：

// Purchase.php
public function transactions()
{
    return $this->hasMany(PurchaseTransaction::class, 'purchases_id', 'purchase_id');
}

// Controller
$dueList = Purchase::withSum('transactions as paid_amount', 'paid_amount')
    ->select('purchase_id', 'bill as total_amount')
    ->get()
    ->map(function ($purchase) {
        return [
            'purchase_id' => $purchase->purchase_id,
            'total_amount' => $purchase->total_amount,
            'paid_amount' => $purchase->paid_amount ?? 0,
            'due_amount' => $purchase->total_amount - ($purchase->paid_amount ?? 0),
        ];
    });