Laravel中如何在pivot中间表定义额外关联获取对应发票数据

默认不能直接通过$user->diploma->pivot->invoice的方式获取对应发票数据，需要对多对多关联做自定义配置后才能实现该访问方式。

1. 创建自定义中间表模型 #

Laravel默认的多对多中间表实例是基础Pivot类，没有定义和发票表的关联，需要先创建对应中间表模型继承Pivot类，在模型内定义和Invoice的关联：

// app/Models/DiplomaUser.php
namespace App\Models;

use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\Pivot;

class DiplomaUser extends Pivot
{
    /**
     * 获取中间记录对应的发票
     */
    public function invoice(): BelongsTo
    {
        return $this->belongsTo(Invoice::class);
    }
}

2. 修改多对多关联配置 #

调整User模型中的diplomas关联，通过withPivot()声明需要用到的中间表字段，通过using()指定刚才创建的自定义中间表模型：

// app/Models/User.php
public function diplomas()
{
    return $this->belongsToMany(Diploma::class)
        ->withPivot('id', 'invoice_id') // 暴露中间表主键、关联发票的外键字段
        ->using(DiplomaUser::class); // 绑定自定义中间表模型
}

建议在Diploma模型的users反向多对多关联中也加上相同的withPivot和using配置，保证反向查询时逻辑一致。

3. 正确调用获取数据 #

注意多对多关联返回的是模型集合，访问时需要遍历每个关联的Diploma实例，通过pivot属性获取中间表模型后再访问invoice关联，建议使用预加载避免N+1查询问题：

// 查询时预加载关联数据，减少SQL查询次数
$user = User::with('diplomas.pivot.invoice')->find($user_id);

// 遍历用户关联的所有文凭，获取对应发票
foreach ($user->diplomas as $diploma) {
    $invoice = $diploma->pivot->invoice;
    // 可直接操作发票实例属性，比如 $invoice->amount
}

• 问题中写的$user->diploma->pivot->invoice首先存在单复数错误：关联名是diplomas（复数），返回的是集合，不能直接访问集合下的pivot属性。
• 如果不加withPivot('invoice_id')，中间表的外键字段不会被加载到pivot实例上，会导致invoice关联查询失败。

内容的提问来源于stack exchange，提问作者Asif Mushtaq