Laravel Eloquent嵌套关联查询获取交易status实现方案

• 预加载层级缺失：原查询仅加载了Availability下的两层关联，未覆盖Booking嵌套的Transaction关联，因此Booking模型下的关联关系为空，无法读取交易状态字段。
• 关联名不匹配：按定义的belongsTo/hasMany关系规则，Availability与Workshop是从属关系（单个排期仅属于一个工作坊），关联名应为单数形式workshop，原查询写为复数workshops会导致关联匹配失败，这也是手动join后集合结构错乱、数据为空的核心诱因。

1. 先核对模型关联定义 #

确保关联名、关系类型和外键配置完全匹配，避免关联加载失败：

// Availability 模型
public function workshop()
{
    // belongsTo 对应单个关联模型，用单数命名
    return $this->belongsTo(Workshop::class);
}
public function bookings()
{
    // hasMany 对应多个关联模型，用复数命名
    return $this->hasMany(Booking::class);
}

// Booking 模型
public function availability()
{
    return $this->belongsTo(Availability::class);
}
public function transaction()
{
    // 单个预订仅关联一笔交易，用单数命名
    return $this->belongsTo(Transaction::class);
}

// Transaction 模型
public function bookings()
{
    return $this->hasMany(Booking::class);
}

2. 编写嵌套预加载查询 #

使用Eloquent的点语法加载多层嵌套关联，可按需指定查询字段减少冗余数据查询，注意预加载指定字段时必须包含关联主键/外键，否则关联匹配失败：

$listWorkshops = Availability::with([
    // 加载排期所属工作坊，指定需要的字段，必须包含主键id
    'workshop:id,title,workshop_cost,vendor_id',
    // 加载排期下的预订，必须包含外键transaction_id用于关联交易
    'bookings:id,availability_id,user_id,is_completed_vendor,is_completed_user,transaction_id,status',
    // 嵌套加载预订对应的交易，必须包含主键id
    'bookings.transaction:id,status,paid_at'
])
->where('vendor_id', $vendor_id)
->orderBy('start_time', 'asc')
->get();

如果需要过滤有效预订（比如排除取消的预订），可以在预加载时加闭包约束：

$listWorkshops = Availability::with([
    'workshop:id,title,workshop_cost,vendor_id',
    'bookings' => function($query) {
        $query->where('status', 'valid') // 仅加载有效预订
            ->select(['id','availability_id','user_id','is_completed_vendor','is_completed_user','transaction_id'])
            ->with('transaction:id,status,paid_at');
    }
])
->where('vendor_id', $vendor_id)
->orderBy('start_time', 'asc')
->get();

3. 层级遍历数据 #

查询返回的集合天然符合「排期->所属工作坊->预订列表->对应交易」的层级结构，直接遍历即可，不需要手动做数据组装：

@foreach($listWorkshops as $availability)
<div class="schedule-block">
    <h3>工作坊：{{ $availability->workshop->title }}</h3>
    <p>排期开始时间：{{ $availability->start_time }}</p>
    <p>工作坊单价：￥{{ $availability->workshop->workshop_cost }}</p>

    <h4>该排期预订记录</h4>
    @forelse($availability->bookings as $booking)
    <div class="booking-item">
        <p>预订用户ID：{{ $booking->user_id }}</p>
        <p>供应商端完成状态：{{ $booking->is_completed_vendor ? '已完成' : '待处理' }}</p>
        <p>用户端完成状态：{{ $booking->is_completed_user ? '已完成' : '待参与' }}</p>
        <p>关联交易状态：{{ $booking->transaction->status }}</p>
    </div>
    @empty
    <p>该排期暂无有效预订</p>
    @endforelse
</div>
@endforeach

• 不要用手动join处理多层一对多关联：join会导致主表数据重复，若分组逻辑不当会直接丢失关联数据，Eloquent嵌套预加载会分多次查询后按外键自动组装层级结构，性能和结构准确性都优于手动join。
• 若遇到关联返回null的情况，优先检查关联名是否和模型定义一致、预加载字段是否包含了必填的主键/外键。
• 单用户对单个工作坊仅1条有效预订的约束，建议在Booking模型的创建逻辑加唯一校验，不要依赖查询层过滤。

内容的提问来源于stack exchange，提问作者Mhluzi Bhaka