SQL语法错误通常源于字段名错误、表别名不匹配或IN参数数量不符，而非TP框架问题；调试需区分生成/绑定/真实执行三层SQL，优先查看Db::getLog()获取带值完整日志。
SQL语法错误不是TP框架的问题，而是你看到的SQL和实际执行的SQL根本不是同一段——调试必须分清“生成的SQL”“绑定后的SQL”“真实执行的SQL”三层。
getLastSql() 为什么返回的SQL跑不通？
它返回的是真正发给MySQL执行过的那条语句，但前提是：该语句已成功执行（哪怕结果为空）。如果查询因语法错误中断，getLastSql() 可能还是上一次成功的SQL，或干脆为空。
- 执行
$model->where('id=1')->select()报错，紧接着调getLastSql()，大概率拿不到出错这条 - 用
Db::query()手写原生SQL时，错误发生在PDO层，getLastSql()不捕获这类语句 - TP8 中若启用了读写分离，
getLastSql()只反映主库最后执行的语句，从库查询不会计入 - 正确做法：先确保查询能走到执行阶段，再取SQL；否则改用
fetchSql()或日志
fetchSql() 返回的 ? 占位符怎么替换成真实值？
fetchSql()（或 _fetchSql(true)）只做SQL拼接，不触碰参数绑定逻辑。它输出的 WHERE id IN (?, ?) 是故意的，不是bug。
- 想看带值的完整SQL，必须开调试模式并查日志：
config/log.php中确保'level'包含'sql' - 或者直接读
Db::getLog()，它返回数组，每个元素含sql（带值）、time、params - 临时关闭预处理（仅开发环境）：在数据库配置里加
'PDO::ATTR_EMULATE_PREPARES' => true，但注意这会绕过PDO安全机制 - 别手动字符串替换占位符——参数类型、NULL、数组展开规则都由PDO控制，硬拼极易出错
多表JOIN后字段名冲突导致查不出数据
ThinkPHP 不会自动给同名字段加表前缀，SELECT user.id, order.id 最终只保留一个 id 字段，且值来自后出现的表（order.id），user.id 被静默覆盖。
立即学习“PHP免费学习笔记（深入）”；
- 必须显式用
AS别名：field('user.id AS user_id, order.id AS order_id') -
join()的 ON 条件里也建议写全表名：'user.id = order.user_id'，避免因字段顺序变化导致条件失效 - 用
view()定义视图时，fetchSql()输出的是 SELECT 部分，不包含 CREATE VIEW，无法验证视图定义本身 - 调试时可先用
toSql()（TP6+）或buildSql()（TP5）确认生成的 SQL 结构是否符合预期
Trace面板里看不到SQL详情？
APP_TRACE=true 只是让右下角小面板可见，它展示的内容深度取决于日志通道是否开启对应级别。面板显示 “SQL: 3 条”，点开却空白，基本就是配置没对上。
- 检查
config/log.php的'level'是否包含'sql'，不能只写['error', 'notice'] - 确保
runtime/log/目录可写，否则日志写失败，Trace 面板自然没数据 - 接口返回 JSON 时 Trace 面板默认不渲染——这不是遗漏，是设计如此；此时必须查日志文件或用
Db::getLog() - TP8 中若用了 Swoole 或 Hyperf 兼容层，Trace 依赖 HTTP 响应生命周期，CLI 或长连接场景下不可见
最常被忽略的一点：你以为的“SQL语法错误”，其实八成是字段名写错、表别名没对上、IN 参数数量不匹配，或是开启了调试但日志级别没配全——先盯住 Db::getLog() 返回的完整结构，比反复猜 fetchSql() 输出靠谱得多。
