ThinkPHP查询报错需综合排查：开启APP_DEBUG、database.php中debug=true且deploy=false、PDO错误模式设为异常，用Db::listen或trace记录真实SQL，注意表前缀、软删除、时间函数及主键名等框架自动干预导致的1054错误，并补全日志钩子记录失败SQL。
ThinkPHP查询报错不能只盯着异常消息，关键要拿到真实执行的SQL和它出错时的上下文。框架做了多层封装，很多错误表面是“SQLSTATE[HY000]”，实际根源可能是字段名拼错、主键不匹配、表前缀自动添加后字段不存在，甚至PDO错误模式被设为静默。
确认调试开关是否真正生效
仅在.env里写APP_DEBUG=true不够。必须确保：
- public/index.php最顶部（任何require之前）有define('APP_DEBUG', true)
- database.php中'debug' => true且'deploy' => false（deploy为true会强制关闭所有调试）
- pdo_params里明确设置PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，否则MySQL原生错误（如1054、1064）会被吞掉
- 删掉整个runtime/目录，避免旧缓存干扰
抓取真正发给数据库的SQL语句
getLastSql()经常为空或不准，因为它只记录“成功执行”的那条。更可靠的方式是监听真实执行流：
- 在出问题的方法开头加：Db::listen(function ($sql, $time, $explain) { dump($sql); });
- 或在config/database.php中开启'trace' => true，SQL会自动记入runtime/log/sql/子目录
- 配合Db::getRealSql()（注意：必须在查询后立刻调用），可看到参数已替换的完整语句，便于直接粘贴到MySQL客户端复现
排查ThinkPHP特有诱因
很多1054错误不是你写错了字段，而是框架自动干预导致的：
立即学习“PHP免费学习笔记（深入）”；
- 表前缀被自动加上，但你在where里写的字段没带前缀，比如->where('user_id', 123)，而实际表是tp_user，字段应为tp_user.user_id
- 软删除字段（如deleted_at）被自动追加IS NULL条件，若该字段不存在就会报1054
- 时间字段（如create_time）被自动转成FROM_UNIXTIME()或UNIX_TIMESTAMP()，函数名写错或字段类型不匹配也会触发
- 主键名不是id，但用了find(123)——框架默认按WHERE id = 123拼，查不到就返回null，不报错；若想报错需显式指定->pk('uid')
让错误落地成可查日志
默认日志不记录SQL失败详情，需手动补钩子：
- 重写think\db\Connection::throwException()，在抛出前用Log::error($e->getSql() . ' | ' . $e->getParams())
- 或在app/event.php中监听think\db\event\AfterExecute，捕获$result === false时写日志
- 确保log.php中'level' => ['sql', 'error']，且runtime/log/目录有写权限
