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