本文详解如何将 doctrine 的 querybuilder 查询（如带参数的范围查询）准确转换为可直接执行的原生 sql，包括自动获取 sql 的方法、手动翻译要点及参数绑定注意事项。
在 Doctrine 开发中，QueryBuilder 提供了面向对象、类型安全的 DQL 构建方式，但有时我们需要查看或调试其底层生成的原生 SQL（例如用于性能分析、数据库直连验证，或在不使用 Doctrine 的环境中复现逻辑）。上述 PHP 代码使用 createQueryBuilder 构建了一个范围查询：筛选 order 字段满足 >= :order 且
✅ 方法一：通过 getSQL() 自动获取（推荐调试用）
若你仍处于 Doctrine 环境中，最直接的方式是在构建查询后调用 getSQL()：
$sql = $repository->createQueryBuilder('r')
->where('r.order >= :order')
->setParameter('order', $nextItem ? $nextItem->getOrder() : 0)
->andWhere('r.order < :order2')
->setParameter('order2', $item->getOrder())
->getQuery()
->getSQL();
echo $sql; // 输出类似：SELECT r.* FROM your_table_name r WHERE r.order >= ? AND r.order < ?⚠️ 注意：getSQL() 返回的是预编译占位符形式（如 ? 或命名参数），并非已替换值的最终 SQL。Doctrine 默认使用问号占位符（PDO 模式），即使你写了 :order，底层也可能转为 ? —— 具体取决于配置和数据库平台。
✅ 方法二：手动翻译为标准原生 SQL
根据实体映射关系，假设该 Repository 对应的数据表名为 items（请按实际表名替换），且 r 别名对应整张表，则等价的原生 SQL 为：
SELECT * FROM items r WHERE r.order >= :order AND r.order < :order2;
若需在 MySQL/PostgreSQL 等环境中直接执行，需显式替换参数（仅用于调试，生产环境严禁拼接字符串！）：
-- 示例：当 $nextItem->getOrder() === 5，$item->getOrder() === 10 SELECT * FROM items r WHERE r.order >= 5 AND r.order < 10;
? 补充说明：
- r.order 中的 r 是表别名，对应 FROM items r；
- order 是保留关键字（如 MySQL 中），若字段名确为 order，建议用反引号包裹：r.`order`；
- 实际表名需依据 Doctrine 实体的 @Table(name="...") 注解或默认命名规则确定（如 Item 实体通常映射到 items 表）。
⚠️ 重要提醒
- 永远不要在生产代码中手动拼接用户输入到 SQL —— 这会导致严重 SQL 注入风险。原生 SQL 执行务必配合 PDO 参数绑定（如 execute(['order' => $val, 'order2' => $val2])）；
- getSQL() 仅返回 SQL 结构，不包含参数值；要查看完整执行语句，可启用 Doctrine SQL Logger 或数据库慢日志；
- 若项目已完全移除 Doctrine，仅需按业务语义还原逻辑：确认表名、字段名、比较边界（>= +
掌握这两种方式，你既能高效调试 Doctrine 查询，也能在无 ORM 环境中精准复现业务逻辑。
