在 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 里处理多对多搜索的健壮路径。
