Laravel多态关联出现N+1查询问题的排查与解决

场景说明 #

通过Laravel多态关联实现多节点类型，Node模型与Company、Property、Individual、Trust等模型建立关联：

Node模型代码 #

public function nodeable()
{
    return $this->morphTo();
}

Company模型（节点类型示例）代码 #

public function node()
{
    return $this->morphOne(Node::class, 'nodeable');
}

问题现象 #

执行以下代码获取节点及关联模型时，出现N+1查询问题：每个节点都会触发一次nodes表查询，尽管后续执行了各关联模型的批量查询，但N+1问题仍未解决。

$nodes = Node::with('nodeable')->get(); 
return NodeResource::collection($nodes);

排查过程 #

• 不使用NodeResource时，N+1查询问题消失；
• 确认传递给资源前，nodeable关联已完成预加载；
• 简化资源逻辑后，问题依然存在；
• 最终定位：问题出在关联模型的资源类中，调用'node_id' => $this->node->id触发了反向关联的N+1查询。

附加问题解答 #

那5个批量查询是多态预加载的正常表现——因为多态关联无法通过单表连接实现，需要按关联类型分别执行批量查询。

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