正确做法是只通过实体关联属性名JOIN，如join('a.movies', 'm')，由Doctrine自动推导中间表；Repository中用createQueryBuilder()而非EntityManager；SELECT显式字段避免全量加载；参数用setParameter()安全绑定。
直接用 QueryBuilder 是 Doctrine 查询最可控的方式，但新手常卡在“怎么连多对多”“为什么 join 报错”“参数怎么传才安全”这几个点上。核心就一条：别碰中间表名，只操作实体属性名。
怎么从 Repository 启动 QueryBuilder
别在 Controller 里 new QueryBuilder，也别用 EntityManager::createQueryBuilder() 硬写。Repository 才是它的自然归属地：
-
MovieRepository里写方法，比如findActorsByMovieId(int $movieId) - 方法体内用
$this->createQueryBuilder('m')，别用$em->createQueryBuilder()—— 前者自动绑定当前实体的元数据，后者要手动 from，容易漏映射 - 如果必须跨实体查（比如 Actor 查 Movie），就用
$em->createQueryBuilder()，但from()必须指定完整类名，如App\Entity\Actor
多对多关系怎么 JOIN 才不报错
错误做法是写 join('movie_actor', 'ma') 或 join(Actor::class, 'a') —— Doctrine 不认识表名，也不接受裸类名作为 join 目标。
正确写法只有一种：用关联属性名。假设 Actor 实体里有 private Collection $movies;，且注解是 @ORM\ManyToMany(inversedBy="actors")，那么：
-
->join('a.movies', 'm')→ 自动推导中间表、ON 条件、别名 -
->where('m.id = :movieId')→ 参数必须用冒号前缀，setParameter('movieId', $id)绑定 - 别名
m是你给 Movie 实体起的，不是数据库表名；Doctrine 生成的 SQL 里它会变成带前缀的临时别名，你不用管
SELECT 字段怎么选才不拖慢性能
默认 select('a') 会加载整个 Actor 实体，触发所有关联和生命周期回调。高并发或大数据量时这是隐患。
- 只取需要字段：
select('a.id', 'a.name', 'a.birthDate')，返回关联数组而非对象 - 避免
select('a')+addSelect('m.title')混用 —— 这会导致 Doctrine 无法识别主实体，getResult()返回混合结构，序列化易出错 - 如果真要对象，用
addSelect('m')+leftJoin('a.movies', 'm')，再加addOrderBy('m.releaseYear')控制顺序
WHERE 和参数绑定的常见陷阱
参数名重复、类型错配、空值处理不当，都会让查询静默失败或抛异常。
-
setParameter('id', $id)和setParameter('id', (int) $id)在 MySQL 中可能结果不同 —— 如果字段是BIGINT，PHP int 溢出后变 float，Doctrine 可能传成科学计数法字符串 - IN 查询别拼字符串：
->where('a.id IN (:ids)')->setParameter('ids', [1,2,3])，Doctrine 自动展开为IN (1, 2, 3) - 空数组传给
setParameter('ids', [])会报错，得提前判断：if (!empty($ids)) { ... } - 日期比较用
DateTimeInterface对象，别传字符串：setParameter('since', new \DateTime('2024-01-01'))
最易被忽略的是：QueryBuilder 构建后，getQuery()->getResult() 返回的是数组或对象集合，而 getScalarResult() 才是纯二维数组 —— 如果你后续要 json_encode 或做简单遍历，别默认用 getResult()。
