Symfony 6.4 中 Doctrine 查询分查单条与查多条：查多条用 getResult() 配合 Repository、参数绑定和 leftJoin；查单条必须用 getSingleResult() 并 try/catch 处理异常；轻量查询用 select() 返回数组提升性能。
在 Symfony 6.4 中用 Doctrine 查询数据，核心是区分“查一条”和“查多条”两种场景——不是靠方法名猜，而是看业务语义和返回结果预期。查单条要防异常、设边界；查多条重结构、控加载。下面直接说清楚怎么做。
查多条：用 getResult() 获取数组列表
这是最常见需求，比如列出所有活跃用户、搜索商品列表。关键点是：用 Repository 封装、参数绑定、避免 N+1。
- 在 UserRepository 中写方法，调用
createQueryBuilder('u')起手 - 条件动态加：第一个用
where()，后续都用andWhere()，每个变量单独setParameter() - 需要关联数据（如用户所属部门）时，用
leftJoin('u.department', 'd')+addSelect('d')，否则关联对象为空 - 不加
setMaxResults()，默认返回全部匹配项；若只取前 20 条，链式加->setMaxResults(20)
查单条：用 getSingleResult() 并必须捕获异常
适用于按主键、唯一字段（如邮箱、SKU）精确查找一个实体。它不返回 null，查不到或查到多个都会抛异常，必须处理。
- 推荐组合：
getSingleResult()+try/catch+setMaxResults(1) -
NoResultException：没查到，可设默认值或返回 404 -
NonUniqueResultException：查到多条，说明 WHERE 条件不够唯一，需检查逻辑 - 别用
findOneBy()替代——它内部也是封装了getSingleResult()，但无法显式限流，也不利于复杂条件复用
轻量查询：只选需要的字段，返回关联数组
不需要完整实体对象时（如 API 返回 ID+名称列表、后台统计），跳过对象映射，减少内存和序列化开销。
- 用
select('u.id', 'u.name', 'u.email')明确字段，不要写select('u') - 关联字段也一样：
leftJoin('u.role', 'r')后接addSelect('r.title') - 调用
getQuery()->getResult()，返回的是二维关联数组，不是实体实例 - 这种写法天然绕过懒加载、序列化循环引用等问题，适合高并发接口
安全与性能提醒
Doctrine 的安全优势来自参数绑定和面向对象抽象，但新手容易忽略几个细节：
- 永远不用字符串拼接 SQL 或 DQL，所有变量走
setParameter() - 多对多查询不要手动 JOIN 中间表，用
join('a.movies')让 Doctrine 自动推导 - 避免在 Twig 模板里调用
$movie->getActors()——如果没预加载，会触发 N+1 查询 - 开发时打开 Symfony Profiler，看“Database”栏的查询次数和 SQL 内容，及时发现隐式查询
