ThinkPHP执行SQL报错多因PHP版本不匹配、pdo_mysql未启用、.env配置失效或调试关闭；需通过phpinfo()确认Web端真实版本，启用pdo_mysql扩展，检查.env路径权限及getenv()可用性，并开启APP_DEBUG查看详细日志。
ThinkPHP执行SQL报错，先看phpinfo()里实际版本
部署后查不到数据或直接报SQL异常，八成不是框架写错了，而是服务器PHP版本和ThinkPHP要求不匹配。比如ThinkPHP 6.1最低要PHP 7.2，但你装的可能是系统默认的PHP 5.6或7.0——这种情况下，pdo_mysql扩展可能加载失败，或者array_key_first()这类函数根本不存在，一执行就Fatal error: Uncaught Error: Call to undefined function。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在Web根目录下建一个
info.php，内容只写<?php phpinfo(); ?>，用浏览器访问确认真实版本 - 别信
php -v命令结果——CLI版本和Web SAPI（如Apache模块、FPM）可能完全不同 - 如果版本偏低，优先升级PHP，而不是降级ThinkPHP；低版本TP安全补丁少，后期维护成本更高
确认pdo_mysql扩展是否启用且可用
ThinkPHP 6默认用PDO连接MySQL，没开pdo_mysql，连数据库都连不上，更别说执行SQL。常见现象是Connection refused或Class 'PDO' not found，但错误提示未必直说缺扩展。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
phpinfo()页面搜索PDO，确认pdo和pdo_mysql两行都显示enabled - Linux下检查
php.ini里有没有extension=pdo_mysql（注意不是extension=php_pdo_mysql.dll） - FPM模式下改了
php.ini必须重启php-fpm服务，不是reload，否则不生效
检查.env中数据库配置是否被环境覆盖
部署后.env文件常被忽略或权限设错，导致TP读不到正确配置，连到空库或测试库，查不出数据还报Table not found。另外，有些主机商禁用getenv()，TP 6.1+默认用getenv()读.env，会失效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认
.env文件在Web可访问路径外（如与public同级），且权限不是777（建议644） - 在
config/database.php里临时把hostname、database等写死，绕过.env验证是否是环境变量问题 - 如果
getenv()不可用，在bootstrap/app.php开头加Dotenv\Dotenv::createImmutable(__DIR__.'/..')->load();强制加载
开启TP调试模式看真实错误而非空白页
生产环境默认关闭调试，SQL报错只显示白屏或500 Internal Server Error，根本看不到具体哪条SQL、哪个参数出问题。尤其是where条件里传了null或空数组，TP生成的SQL语法可能非法。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 临时在
.env里设APP_DEBUG=true，并确保LOG_LEVEL=debug - 查看
runtime/log/下的日志文件，重点找含SQLSTATE或mysqli_sql_exception的记录 - 如果日志里出现
SQL: SELECT * FROM `user` WHERE `id` = ?但没打印绑定值，说明预处理参数没传进去——检查where()调用时是不是用了引用传递或闭包写法错误
真正卡住的地方，往往不是SQL本身，而是PHP运行时环境和TP加载机制之间的缝隙。比如FPM子进程缓存了旧的php.ini，或者OPcache没清导致类加载异常——这些不会报错，但会让SQL执行行为变得不可预测。
