Symfony 6 中使用 findBy 查询多对多关联实体的正确方法

在 Symfony 6 的项目里，用 findBy() 通过表单提交的对象直接查询，这条路是走不通的。正确的做法是显式地提取字段值，比如 $form->get('color')->getData()。除此之外，还得留意多对多关系查询时的一些限制，以及对应的替代方案。

很多开发者刚上手时，都容易掉进一个坑：试图把表单数据一股脑儿传给 Repository::findBy()，以为它能自动处理多对多关系。问题是，$form->getData() 返回的根本不是我们想要的键值对数组，而是一个表单数据对象——这里具体是 CardSearchType 对应的空数据对象。

而 findBy() 只认 array $criteria 这种格式，比如 ['name' => 'foo', 'color' => $colorEntity]。更关键的是，Doctrine 并不支持直接用多对多关联字段作为 findBy() 的条件键。如果你试图用 'color' => $color，它在底层会尝试匹配 Card.color 属性，可这个属性是 Collection 类型，既不是标量，也不是单个实体引用，根本没法比较。所以，原代码里那种写法：

$cardData = $form->getData();
$cards = $cardRepository->findBy($cardData); // ❌ 错误：$cardData 是对象，且 'color' 键无法被 findBy 解析

必然会导致 Warning: Trying to access array offset on value of type null——因为 $cardData 不是数组，findBy() 内部尝试访问它的键时，只能得到一个空值。

正确做法：显式提取 + 使用自定义 DQL 或 QueryBuilder

✅ 方案一：简单场景 —— 单色筛选（使用 findBy() + 关联实体）

如果只是查找“包含指定 Color 的 Card”，而且 Color 实体已经加载好了（比如来自下拉选择框），那么可以这样用：

if ($form->isSubmitted() && $form->isValid()) {
    $selectedColor = $form->get('color')->getData(); // ✅ 返回 Color 实体或 null
    if ($selectedColor) {
        // 注意：此方式要求 Color 实体存在且非 null
        $cards = $cardRepository->findBy(['color' => $selectedColor]);
    } else {
        $cards = []; // 或 findAll()
    }
}

这里有个细节：Doctrine 确实允许 findBy(['relationField' => $entity]) 这种写法用于多对多，但前提是数据库里存在连接表，并且 Doctrine 能自动生成正确的 JOIN 语句。Symfony 6 + Doctrine ORM 默认支持这一点。不过，这个语法有点依赖内部行为，不够透明，所以更推荐下面这种明确的方案。

✅ 方案二（推荐）：使用自定义 Repository 方法（清晰、可控、可扩展）

在 CardRepository 里加一个专用方法，用 QueryBuilder 显式地 JOIN：

// src/Repository/CardRepository.php
public function findByColor(?Color $color): array
{
    if (!$color) {
        return [];
    }

    return $this->createQueryBuilder('c')
        ->innerJoin('c.color', 'col')
        ->where('col.id = :colorId')
        ->setParameter('colorId', $color->getId())
        ->getQuery()
        ->getResult();
}

然后在控制器里调这个方法：

if ($form->isSubmitted() && $form->isValid()) {
    $selectedColor = $form->get('color')->getData();
    $cards = $cardRepository->findByColor($selectedColor);
}

✅ 方案三：支持多选颜色（AND / OR 逻辑）

如果未来需求扩展，要支持多选颜色（比如复选框），findBy() 就完全没法用了，必须用 QueryBuilder。

下面的代码演示的是“AND”逻辑——查找同时包含所有指定颜色的 Card：

// Repository 方法：查找同时包含所有指定颜色的 Card（AND）
public function findByColorsAnd(array $colors): array
{
    if (empty($colors)) return [];

    $qb = $this->createQueryBuilder('c');
    foreach ($colors as $index => $color) {
        $qb->innerJoin('c.color', 'col' . $index)
           ->andWhere('col' . $index . '.id = :' . $index)
           ->setParameter($index, $color->getId());
    }
    return $qb->getQuery()->getResult();
}

补充注意事项

• 表单配置优化：当前 CardSearchType 里的 EntityType 缺少 multiple => true 和 expanded => false（默认是下拉）。如果允许多选，必须显式设置，并且在 Controller 里用 $form->get('color')->getData() 获取 Color[] 数组。
• 空值处理：务必检查 $form->get('xxx')->getData() 是否为 null，避免 findBy(['color' => null]) 这种写法引发意外行为。
• 性能提示：多对多查询很容易触发 N+1 问题，建议在 Repository 方法里用 leftJoin() + addSelect() 预加载关联数据，比如 addSelect('col')。

总结一下：别再把整个表单数据对象直接扔给 findBy() 了。精准提取字段，结合自定义的 Repository 查询，这才是 Symfony 6 里处理多对多搜索的健壮路径。