Laravel 9 Eloquent多表关联查询问题：关联数据未加载及预约筛选

问题背景 #

使用Laravel 9框架，已定义以下模型关联：

• Client模型（主键ID）：与Appointment、Vehicle为一对多关联
• Appointment模型（外键client_id）：与Client为多对一关联
• Vehicle模型（外键client_id）：与Client为多对一关联

执行查询时，返回的Client模型未附带关联的预约和车辆数据，同时需要筛选出预约类型为test的记录，并实现结果遍历：

class DashboardController extends Controller
{
    public function __invoke()
    {
        $clients = Client::with(['appointments', 'vehicles'])
        ->where('default_location', 'MM Alencar')
        ->get()
        ->dd();

        // return view('dashboard', ['clients' => $clients]);
    }
}

问题解决步骤 #

1. 排查关联数据未加载的问题 #

先确认以下核心点：

• 检查数据库中对应Client的client_id是否存在于appointments和vehicles表中，确保有实际关联数据
• 验证模型关联的外键是否与数据库字段完全一致（避免拼写、大小写错误）
• 可用withCount快速验证关联数据数量，辅助排查：

$clients = Client::withCount(['appointments', 'vehicles'])
    ->where('default_location', 'MM Alencar')
    ->get();
// 查看每个client的appointments_count和vehicles_count，确认是否有数据

2. 筛选预约类型为test的记录 #

要同时实现加载筛选后的预约、关联车辆，且可选保留仅含符合条件预约的Client，修改后的查询代码如下：

class DashboardController extends Controller
{
    public function __invoke()
    {
        $clients = Client::with([
            // 筛选关联的预约记录（类型为test）
            'appointments' => function ($query) {
                $query->where('type', 'test'); // 替换为实际的预约类型字段名
            },
            'vehicles' // 加载所有关联车辆
        ])
        ->where('default_location', 'MM Alencar')
        // 可选：仅保留拥有符合条件预约的Client，需取消注释以下代码
        // ->whereHas('appointments', function ($query) {
        //     $query->where('type', 'test');
        // })
        ->get();

        return view('dashboard', ['clients' => $clients]);
    }
}

3. 遍历查询结果 #

在视图文件dashboard.blade.php中，通过嵌套循环遍历数据：

@foreach($clients as $client)
    <div class="client-item">
        <h3>客户信息：{{ $client->name }}</h3>
        <p>默认地址：{{ $client->default_location }}</p>

        <h4>符合条件的预约记录：</h4>
        @if($client->appointments->isNotEmpty())
            <ul>
                @foreach($client->appointments as $appointment)
                    <li>预约ID：{{ $appointment->id }} | 预约时间：{{ $appointment->created_at->format('Y-m-d H:i') }}</li>
                @endforeach
            </ul>
        @else
            <p>无匹配的预约记录</p>
        @endif

        <h4>关联车辆：</h4>
        @if($client->vehicles->isNotEmpty())
            <ul>
                @foreach($client->vehicles as $vehicle)
                    <li>车辆牌照：{{ $vehicle->license_plate }} | 车型：{{ $vehicle->model }}</li>
                @endforeach
            </ul>
        @else
            <p>无关联车辆</p>
        @endif
    </div>
@endforeach

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