
本文详解如何在 laravel 中通过 eloquent 正确建立 services_cats、session_pat、invoice_item 和 invoice 四张表之间的级联关系,并规避因字段名重复(如 `id`)导致的 sql “column 'id' in field list is ambiguous” 错误。
在 Laravel 中实现跨四张表(Services_cats → Session_pat → Invoice_item → Invoice)的高效、可读、无歧义的关联查询,关键不在于堆砌 with() 嵌套,而在于精准定义模型关系 + 显式限定字段来源 + 避免隐式 JOIN 冲突。
首先,需纠正原始关系定义中的逻辑偏差:Invoice::invoice_item() 不应使用 belongsToMany(该方法适用于多对多中间表含两个外键且无业务属性的场景),而 invoice_items 表实际是 Invoice 与 Session_pat 之间的带属性的关联表(含 service_id、invoice_id),更符合 hasManyThrough 的变体或标准一对多+多对一组合。但根据字段结构,推荐采用清晰的三层显式关系链:
- Invoice → hasMany → InvoiceItem(invoice_items 表,主键 id,外键 invoice_id/service_id)
- InvoiceItem → belongsTo → SessionPat(通过 service_id 关联 session_pats.id)
- SessionPat → belongsTo → ServicesCat(通过 services_cat_id 关联 services_cats.id)
✅ 正确的模型关系定义如下:
// app/Models/Invoice.php
public function items()
{
return $this->hasMany(InvoiceItem::class, 'invoice_id');
}
// app/Models/InvoiceItem.php
public function sessionPat()
{
return $this->belongsTo(SessionPat::class, 'service_id', 'id');
}
public function invoice()
{
return $this->belongsTo(Invoice::class, 'invoice_id', 'id');
}
// app/Models/SessionPat.php
public function servicesCat()
{
return $this->belongsTo(ServicesCat::class, 'services_cat_id');
}接着,在查询时必须为所有 select() 中的字段加上表名前缀,以消除 id 等通用字段的歧义(这是报错的根本原因)。Eloquent 在 with() 的闭包中执行子查询时,若未指定表名,会将 id 解析为当前查询上下文的默认表(如 session_pats.id),而 invoice_items 表也含 id,导致冲突。
✅ 正确的一次性四级关联查询(获取 ID=122 的 Invoice 及其完整服务分类路径):
$status4 = Invoice::select('invoices.id', 'invoices.code', 'invoices.discount')
->with([
'items' => function ($q) {
$q->select('invoice_items.id', 'invoice_items.invoice_id', 'invoice_items.service_id')
->with([
'sessionPat' => function ($q2) {
$q2->select('session_pats.id', 'session_pats.services_cat_id')
->with([
'servicesCat' => function ($q3) {
$q3->select('services_cats.id as cat_id', 'services_cats.name');
}
]);
}
]);
}
])
->where('invoices.id', 122)
->first(); // 使用 first() 更合理(单条记录)? 关键注意事项:
- ✅ 始终在 select() 中使用 table.column 格式(如 'invoices.id'),绝不写 'id';
- ✅ with() 中每个嵌套闭包的 select() 必须包含其外键字段(如 invoice_items.service_id),否则后续 belongsTo 关联无法匹配;
- ✅ first() 优于 get() 当仅需单条记录,减少内存开销;
- ❌ 避免在中间模型(如 InvoiceItem)上错误使用 belongsToMany——它会触发额外的 inner join 并尝试解析 pivot 字段,直接引发 ambiguous column 错误;
- ? 若需反向查询(如从 ServicesCat 查所有关联 Invoice),可定义 hasManyThrough,但需确保中间表结构支持(此处 SessionPat 并非严格中间表,建议优先用上述三层链式关系)。
通过规范关系定义与显式字段限定,即可安全、高效地实现四表深度关联,既保持代码可维护性,又彻底规避 SQL 字段歧义问题。










