必须通过 getConnection() 获取 DBAL Connection 实例来执行原生 SQL，不可直接 new PDO 或误用旧方法；SELECT 用 executeQuery() + fetchAllAssociative()，增删改用 executeStatement()；参数须绑定，禁拼接；注意事务与 ORM 缓存一致性。
用 getConnection() 获取原生连接对象
Doctrine ORM 层不直接执行 SQL，必须降级到 DBAL 层。所有原生 SQL 操作都从 getConnection() 开始，它返回一个 Doctrine\DBAL\Connection 实例，不是 PDO 对象，但接口兼容。
常见错误是误调 getEntityManager()->getConnection()（旧写法）或试图在 Repository 里直接 new PDO——这会绕过 Doctrine 的连接管理、事务控制和配置复用。
- 正确入口：在 Controller 或 Service 中注入
EntityManagerInterface，再调$em->getConnection() - 也可以直接注入
Connection（需在 services.yaml 中配置别名或使用 autowire） - 连接对象是单例，多次调用
getConnection()返回同一实例，无需缓存
executeQuery() vs executeStatement() 的区别
DBAL 把 SQL 分成两类：带结果集的（SELECT）和不带结果集的（INSERT/UPDATE/DELETE/DROP）。选错方法会导致逻辑错误或静默失败。
-
executeQuery()：只用于 SELECT，返回Statement对象，必须链式调用fetchAllAssociative()、fetchOne()等获取数据 -
executeStatement()：用于 INSERT/UPDATE/DELETE，返回受影响行数（int），不能用来取结果 - 用
executeQuery()执行 UPDATE 会抛出InvalidFieldNameException；反之，用executeStatement()执行 SELECT 不报错但返回 0，容易误判为“没执行成功”
参数绑定必须用 ? 或命名占位符
字符串拼接 SQL 是硬性禁止的，哪怕参数来自 config 或 enum 常量。Doctrine 不做任何 SQL 转义，全靠参数绑定机制防注入。
- 数组参数要用
Connection::PARAM_INT_ARRAY或Connection::PARAM_STR_ARRAY显式声明类型，否则IN (?)会被当成单个字符串处理 - 命名参数写法：
WHERE id = :id AND status IN (:statuses)，传参时用['id' => 123, 'statuses' => [1, 2]]，并配[':id' => \PDO::PARAM_INT, ':statuses' => Connection::PARAM_INT_ARRAY] - 不要混用：同一 SQL 中不能同时出现
?和:name
结果映射不到实体时，优先用 fetchAllAssociative()
原生 SQL 默认不走 ORM 映射，fetchAll() 返回数字索引数组（如 [0 => 1, 1 => 'foo']），而 fetchAllAssociative() 返回键名数组（['id' => 1, 'name' => 'foo']），后者更符合日常使用习惯。
- 需要转成 Entity 实例？得手动 new 或用
ResultSetMapping（RSM），但 RSM 配置成本高，仅当必须复用 Entity 生命周期钩子时才值得用 -
fetchOne()只取第一行第一列，适合 COUNT、MAX 等标量查询；fetchAssociative()取单行带键名数组 - 如果 SQL 含多个同名列（如 JOIN 两张都有
id字段），DBAL 会覆盖，此时必须用AS显式重命名字段
真正麻烦的不是怎么写，而是怎么让原生 SQL 和 Doctrine 的事务、连接生命周期、连接池行为保持一致——比如在事务中执行原生语句后，ORM 级别的 flush() 仍会生效，但若原生语句改了被 ORM 缓存的行，后续 find() 可能返回脏数据。这点很少被文档强调，却常在线上引发难以复现的数据不一致。
