使用EAGER加载仍遇Doctrine多对多关联N+1查询问题

核心问题定位 #

你的多对多关联映射配置存在错误，这是导致EAGER加载不生效、触发N+1查询的根本原因：

• 多对多关联的双方不能同时使用mappedBy，必须一方用inversedBy（拥有方），另一方用mappedBy（关联方）
• #[ORM\JoinTable]注解仅需配置在关联的拥有方，无需重复添加

步骤1：修正实体关联映射 #

Car实体（作为关联拥有方）

#[ORM\ManyToMany(targetEntity: Driver::class, inversedBy: 'cars', fetch: 'EAGER')]
#[ORM\JoinTable(name: "cars_to_drivers")]
private Collection $drivers;

Driver实体（作为关联方）

#[ORM\ManyToMany(targetEntity: Car::class, mappedBy: 'drivers', fetch: 'EAGER')]
private Collection $cars;

关键说明：

• mappedBy的值必须对应拥有方的关联属性名（这里是Car的$drivers）
• inversedBy的值对应关联方的关联属性名（这里是Driver的$cars）
• 仅拥有方需要配置JoinTable，关联方无需重复定义

步骤2：添加API Platform查询扩展强制关联加载 #

即使修正了映射，API Platform的默认查询逻辑可能仍未自动执行关联查询，需创建Doctrine扩展主动添加左连接：

<?php

namespace App\Doctrine\Extension;

use ApiPlatform\Doctrine\Orm\Extension\QueryCollectionExtensionInterface;
use ApiPlatform\Doctrine\Orm\Util\QueryNameGeneratorInterface;
use ApiPlatform\Metadata\Operation;
use App\Entity\Car;
use Doctrine\ORM\QueryBuilder;

class CarCollectionExtension implements QueryCollectionExtensionInterface
{
    public function applyToCollection(QueryBuilder $queryBuilder, QueryNameGeneratorInterface $queryNameGenerator, string $resourceClass, Operation $operation = null, array $context = []): void
    {
        if ($resourceClass !== Car::class) {
            return;
        }

        $rootAlias = $queryBuilder->getRootAliases()[0];
        // 左连接司机关联并选中对应数据
        $queryBuilder->leftJoin(sprintf('%s.drivers', $rootAlias), 'd');
        $queryBuilder->addSelect('d');
    }
}

验证效果 #

重启应用后调用GET接口获取汽车数据，查看Doctrine分析器：

• 仅会执行1次计数查询、1次带左连接的主查询
• 原有的30次单条汽车的司机查询会被彻底消除

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