多对多“AND查询”需为每个条件创建独立JOIN并分配不同别名，如a0、a1；select()必须在最前且仅一次，后续用addSelect()；动态WHERE须用expr()->andX()统一构建；原生函数如GROUP_CONCAT需注册为自定义DQL函数。
多对多“AND 查询”必须用多个 JOIN 别名
想查同时满足多个关联条件的实体（比如“既是红色又是大号的产品”），不能只写一个 join('p.attributes', 'a') 然后反复 andWhere('a.slug = :slug1 AND a.slug = :slug2')——这在 SQL 层面根本不可能成立，因为单行记录的 a.slug 不可能同时等于两个值。
正确做法是为每个条件创建独立的 JOIN，并分配不同别名：
- 循环中每次调用
join('p.attributes', 'a'.$i)，生成a0、a1等别名 - 每个 JOIN 后紧跟对应
andWhere('a'.$i.'.slug = :slug'.$i) - 必须用
setParameter()绑定每个参数，避免 SQL 注入和类型错位
本质是把“同一张中间表”按需多次引入，让数据库能对每条匹配路径做独立判断。漏掉任意一次 join 或别名重复，结果都会为空。
select() 和 addSelect() 控制字段粒度
默认 getQuery()->getResult() 返回完整实体对象，但很多场景只需 ID、名称等几个字段，或要拼接关联字段又不加载整个关联对象——这时 select() 和 addSelect() 就不是可选项，而是性能关键。
常见误操作是只写 select('p.id, p.name') 却忘了加 ->addSelect('c.title')，导致 leftJoin 的字段不进结果集；或者错误地用 select('p, c')，反而触发全量对象 hydrate，失去字段裁剪意义。
-
select()必须放在最前，且只能调用一次；后续字段用addSelect() - 关联字段别名建议显式声明，如
addSelect('c.title AS category_title')，避免 key 冲突 - 如果只要标量结果（非对象），最后要用
getQuery()->getScalarResult()，否则 Doctrine 仍尝试构造实体
动态 WHERE 条件必须用 expr()->andX() / orX()
运行时决定是否添加某个过滤条件（比如搜索表单里“价格范围”字段可空），直接拼字符串或条件性调用 andWhere() 容易出错：空条件会残留上一次的 WHERE 子句，或导致语法错误。
正确方式是用表达式构建器统一收口：
- 初始化：
$expr = $qb->expr() - 收集条件：
$andConditions = $expr->andX()，然后循环中$andConditions->add($expr->gte('p.price', ':minPrice')) - 最后统一
$qb->where($andConditions) - 空数组时
andX()生成空条件，不会报错也不会污染 SQL
注意：不要在循环里反复调用 $qb->andWhere() 并依赖 if 判断——QueryBuilder 的链式调用是累积的，没“撤销”机制。
GROUP_CONCAT 等原生函数需注册自定义 DQL 函数
QueryBuilder 默认不支持 GROUP_CONCAT、JSON_AGG 这类数据库特有函数，直接写 addSelect('GROUP_CONCAT(a.name)') 会报 DQL 解析错误，不是语法错，是 Doctrine 根本不认识这个词。
必须提前注册为自定义 DQL 函数：
- 写一个继承
FunctionNode的类，实现getSql()返回原生 SQL 片段 - 在 Doctrine 配置中通过
dql.functions注册，如group_concat: App\Doctrine\Functions\GroupConcat - 之后才能在
select()或having()中安全使用GROUP_CONCAT
这个步骤容易被跳过，开发者常误以为是 QueryBuilder 用法问题，实际是 Doctrine 的 DQL 解析层限制——它不直通 SQL，所有函数都得白名单准入。
