Doctrine独立版关联查询异常：JOIN未自动生成ON条件

正确DQL写法（满足需求） #

要实现仅返回拥有名称以"-1"结尾子家族的家族，且家族关联的子家族集合仅保留匹配项，需使用FETCH JOIN结合WITH条件，并添加DISTINCT去重：

SELECT DISTINCT f, s
FROM App\Entity\Family f
JOIN f.subfamilies s WITH s.name LIKE '%-1'

问题根源分析 #

你之前的查询存在两个核心问题：

1. 未使用FETCH JOIN：普通JOIN仅会生成家族与匹配子家族的笛卡尔积，不会将过滤后的子家族关联到家族实体的subfamilies集合中，导致返回重复家族记录，且家族的子家族集合仍保留全部数据。
2. 映射配置可能有误：若生成的SQL无JOIN的ON条件，大概率是Family与Subfamily的关联映射配置错误——比如mappedBy/inversedBy的字段名不匹配，或未正确设置@ORM\JoinColumn。

校验实体关联映射 #

确保一对多/多对一映射配置正确，这是Doctrine自动生成ON条件的基础：

Family实体（一对多侧） #

<?php
namespace App\Entity;

use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class Family
{
    /**
     * @ORM\Id
     * @ORM\GeneratedValue
     * @ORM\Column(type="integer")
     */
    private ?int $id = null;

    /**
     * @ORM\OneToMany(targetEntity=Subfamily::class, mappedBy="family", cascade={"persist", "remove"})
     */
    private Collection $subfamilies;

    public function __construct()
    {
        $this->subfamilies = new ArrayCollection();
    }

    // 省略getter/setter
}

Subfamily实体（多对一侧） #

<?php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class Subfamily
{
    /**
     * @ORM\Id
     * @ORM\GeneratedValue
     * @ORM\Column(type="integer")
     */
    private ?int $id = null;

    /**
     * @ORM\Column(type="string", length=255)
     */
    private ?string $name = null;

    /**
     * @ORM\ManyToOne(targetEntity=Family::class, inversedBy="subfamilies")
     * @ORM\JoinColumn(nullable=false)
     */
    private ?Family $family = null;

    // 省略getter/setter
}

备选方案（仅过滤家族，懒加载子家族） #

若无需立即加载匹配的子家族，仅需筛选出拥有符合条件子家族的家族，可使用EXISTS子查询：

SELECT f
FROM App\Entity\Family f
WHERE EXISTS (
    SELECT s
    FROM App\Entity\Subfamily s
    WHERE s.family = f AND s.name LIKE '%-1'
)

此方式不会加载子家族数据，后续访问$family->getSubfamilies()时会触发懒加载（若需仅加载匹配项，仍需使用第一种FETCH JOIN写法）。

常见误区规避 #

• 不要用WHERE替代WITH：若写JOIN f.subfamilies s WHERE s.name LIKE '%-1'，Doctrine会先执行全量关联JOIN再过滤结果，返回笛卡尔积记录，且家族的子家族集合仍保留全部数据。
• 必须加DISTINCT：FETCH JOIN会生成家族与匹配子家族的笛卡尔积，导致结果中出现重复的Family实体，DISTINCT可实现实体去重。

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