Symfony 3 中用 QueryBuilder 写复杂条件需通过链式调用 where/andWhere/orWhere 添加条件，用户输入必须用 setParameter 绑定防注入，关联用实体属性名如 u.posts，高级逻辑用 expr()->andX/orX 构建。
Symfony 3 中用 QueryBuilder 写复杂条件，关键不是拼 SQL，而是用对象化方式组合逻辑——既要安全防注入，又要清晰表达业务规则。
QueryBuilder 是 Doctrine 在 Symfony 3 中构建动态查询的主力工具，比原生 SQL 安全，比 DQL 更灵活，特别适合带多条件筛选、关联表、模糊匹配或嵌套逻辑的场景。
复杂条件怎么写才靠谱？
- 条件必须通过
where()/andWhere()/orWhere()链式调用添加，不能字符串拼接 - 所有用户输入值必须用
setParameter()绑定，避免 SQL 注入 - 多表关联只认实体关系属性名（比如
u.posts），不认数据库中间表名 -
expr()对象用来构造高级表达式，比如LIKE、IN、BETWEEN、嵌套AND/OR
例如，查“活跃且邮箱含关键词”的用户：
$qb = $this->createQueryBuilder('u');
$qb->where('u.isActive = :active')
->andWhere($qb->expr()->like('u.email', ':pattern'))
->setParameter('active', true)
->setParameter('pattern', '%' . $keyword . '%');多表 JOIN + 复合筛选怎么组织？
假设要查“发布过至少一篇公开文章的活跃作者”，涉及 User 和 Post 关联：
$qb = $this->createQueryBuilder('u')
->innerJoin('u.posts', 'p') // 关联属性名，非表名
->where('u.isActive = :active')
->andWhere('p.isPublished = :published')
->groupBy('u.id')
->having('COUNT(p.id) > 0')
->setParameter('active', true)
->setParameter('published', true);注意：
-
innerJoin('u.posts', 'p')中'u.posts'是 User 实体里定义的$posts属性名 -
having()必须配合groupBy()，不能直接写WHERE COUNT(...) > 0 -
COUNT(p.id)要明确字段，避免COUNT(*)在分组时语义模糊
动态 AND/OR 嵌套条件怎么处理？
比如前端传来 JSON 规则：(status = 'draft' AND price < 100) OR (status = 'published' AND tags CONTAINS 'news')
QueryBuilder 本身不支持直接解析 JSON，但可用 expr()->andX() / expr()->orX() 搭建逻辑树：
$orExpr = $qb->expr()->orX();
$and1 = $qb->expr()->andX()
->add($qb->expr()->eq('p.status', ':draft'))
->add($qb->expr()->lt('p.price', ':price'));
$and2 = $qb->expr()->andX()
->add($qb->expr()->eq('p.status', ':pub'))
->add($qb->expr()->like('p.tags', ':tag'));
$orExpr->add($and1)->add($and2);
$qb->where($orExpr)
->setParameter('draft', 'draft')
->setParameter('price', 100)
->setParameter('pub', 'published')
->setParameter('tag', '%news%');常见坑点提醒
- ❌ 别在 Controller 里直接 new QueryBuilder 或用
$em->createQueryBuilder()—— 应该封装在 Repository 方法里 - ❌ 别写
join('user_post', 'up')—— Doctrine 不识别物理表名，只认u.posts这类映射关系 - ❌ 别漏
setParameter()或重复用同一名字 —— 参数名冲突会导致绑定失效 - ✅ 复杂查询建议返回数组（
getResult()）而非实体对象，减少代理初始化开销 - ✅ 模糊搜索记得加
%，但不要在数据库字段上用LOWER()函数做大小写忽略 —— 应靠 collation 或ILIKE（PostgreSQL）处理
不复杂但容易忽略。
