Laravel多对多关联返回NULL问题排查求助

我帮你梳理下代码里几个可能导致关联返回NULL的关键点，咱们一个个来排查：

1. 模型主键属性拼写错误 #

在TenderMaster模型里，你写的是：

protected $primarykey = 'id';

Laravel的模型属性是驼峰命名规则，正确的写法应该是$primaryKey（大写K），这个拼写错误会导致Laravel无法正确识别主键，直接关联查询失败。修改后：

protected $primaryKey = 'id';

2. 中间表与关联字段的一致性检查 #

先确认数据库里的中间表hmsc_bid_origin_port_comm确实存在，并且里面有对应bid_id（关联hmsc_tender的id）和port_id（关联hmsc_air_port_codes的id）的有效记录——如果中间表没有数据，关联自然返回空集合。

另外检查模型关联里的字段顺序：你在TenderMaster的Ports方法里写的是bid_id在前、port_id在后，AirPortCode的Tenders方法里是port_id在前、bid_id在后，这个顺序是对的（当前模型主键在前，关联模型主键在后），这部分没问题。

3. Blade视图里的关联调用错误 #

你在视图里直接用{{$tenders->Ports['port_id']}}，但Ports是多对多关联，调用时返回的是模型集合（可能包含多个港口），不是单个模型，所以不能直接用数组索引取port_id。

正确的用法分两种：

• 只取第一个关联的港口ID：

{{$tenders->Ports->first()->port_id ?? '无关联港口'}}

• 遍历所有关联的港口：

@foreach($tenders->Ports as $port)
    {{$port->port_id}}{{!$loop->last ? ', ' : ''}}
@endforeach

4. Blade循环变量名冲突 #

你的循环代码里：

@foreach($tender as $key => $tenders)

这里的循环变量$tenders和外层可能存在的变量重名了，很容易导致逻辑混乱，建议改成更清晰的命名，比如：

@foreach($tenderList as $singleTender)
<tbody>
<td>{{$singleTender->bid_name}}</td>
<td>{{$singleTender->bid_year}}</td>
<td>{{$singleTender->shipping_mode}}</td>
<td>{{$singleTender->start_date}}</td>
<td>
    @foreach($singleTender->Ports as $port)
        {{$port->port_id}}{{!$loop->last ? ', ' : ''}}
    @endforeach
</td>
<!-- 其他按钮列 -->
</tbody>
@endforeach

5. 预加载关联（优化性能+确保数据加载） #

在控制器查询TenderMaster的时候，记得用预加载with()方法，这样不仅能避免N+1查询问题，还能确保关联数据被正确加载：

$tenderList = \App\Tender_Module\Admin_Module\TenderMaster::with('Ports')->get();

再把这个集合传到视图里使用。

用Tinker验证的正确姿势 #

在tinker里测试关联时，要先预加载关联再查看：

$tender = App\Tender_Module\Admin_Module\TenderMaster::with('Ports')->first();
$tender->Ports; // 这里应该返回关联的集合，而非NULL

如果还是NULL，就去检查中间表是否有对应的数据，或者主键、外键的类型是否匹配（比如都是int类型）。

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