ThinkPHP数据库连接在宝塔面板下90%问题源于环境、权限、路径或框架机制不匹配，而非配置写错；需重点排查PDO异常关闭导致静默失败、表名双前缀、字段映射不一致及pdo_mysql扩展未正确加载等问题。
ThinkPHP 数据库配置在宝塔面板下出问题，90% 不是写错了，而是环境、权限、路径或框架机制没对齐。最常卡在“连得上但查不到”“表名拼错”“静默失败没报错”这三类场景。
数据库连接看似成功，实则未生效
宝塔里填对 hostname、username、password、database，不代表真能连。ThinkPHP 6 默认关闭 PDO 异常模式，连接失败时只会返回 false，不抛异常，也不报错页面——你看到白屏或空数组，可能只是连不上。
- 在控制器里临时加一行：
echo \think\facade\Db::query("SELECT 1")->fetchColumn();，输出 1 才算真正通了 - 若报 PDOException 或超时，检查 MySQL 是否监听 127.0.0.1（而非 localhost，后者可能走 socket）
- 宝塔默认 MySQL 连接数限制为 150，ThinkPHP 多请求并发时易耗尽，需进「数据库」→「MySQL 配置」调高
max_connections
表名拼错：前缀配置+模型命名双坑
查不到数据？先看 SQL 日志或用 Db::getLastSql() 打印实际执行语句。常见错误是生成了 tp_tp_user 这种双前缀表名。
-
config/database.php中'prefix' => 'tp_'必须带末尾下划线，且不能有空格 - 模型类（如
app/model/User.php）中写protected $name = 'user';，不是'tp_user' - 文件名、类名、命名空间必须严格一致：文件叫
User.php，类是class User extends Model，命名空间是app\model - 想跳过前缀直接指定表，用
protected $table = 'tp_user';，它会完全忽略prefix和$name
字段映射失效：逻辑名 vs 数据库名
模型查出来字段为空、或取不到值，不是数据库没数据，而是字段映射断了。
立即学习“PHP免费学习笔记（深入）”；
-
$fillable填的是逻辑字段名（如'nick_name'），不是数据库字段（如'nickname'），两者必须一致 - 字段类型严格校验会拦截非标准类型（如 JSON 字段在 MySQL 5.7 中被当 text），在 database.php 中设
'fields_strict' => false - 使用
Db::name('user')->field('id,nickname')->select()绕过模型层，可快速验证是否是模型映射问题
socket 路径与扩展加载错位
明明装了 pdo_mysql，却报 Driver [mysql] not supported，本质是 PHP 实例和扩展没对上。
- 宝塔给不同 PHP 版本装扩展的路径不同，切换 PHP 版本后，原扩展不会自动迁移
- 进「软件管理」→ 找到当前站点用的 PHP 版本 → 「设置」→ 「安装扩展」→ 确保勾选
pdo_mysql和mysqli - 检查
phpinfo()页面中Loaded Configuration File路径，确认修改的是该 PHP 实例的php.ini - MySQL 若启用了 socket 连接（
unix_socket），需在 database.php 中明确指定'unix_socket' => '/www/server/data/mysql.sock'
