ThinkPHP项目启动后查询报错、字段取不到值、模型返回空数组，问题多出在数据库配置未生效或表名/字段映射错误；需验证Db::query("SELECT 1")->fetchColumn()是否返回1，确认连接成功，并检查$model->getTable()输出是否与真实表名一致，同时确保$fillable使用逻辑字段名而非数据库字段名。
ThinkPHP项目启动后查询直接报错、字段取不到值、模型返回空数组，这些问题八成出在数据库配置和字段映射的衔接环节——不是SQL写错了，而是框架根本没连上你认为它该连的库，或者连上了却把字段名认成了另一套规则。
检查数据库连接是否真正生效
打开 config/database.php，确认 'hostname'、'username'、'password'、'database' 四项已填且可被真实访问；仅填对不等于能连上，必须验证。
在任意控制器中插入一行代码：echo Db::query("SELECT 1")->fetchColumn();，若输出 1 则连接通；若报 PDOException 或返回 false，则说明配置未生效或权限不足。
注意：TP6 默认关闭 PDO 异常模式，【未配置 'pdo_attr' => [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION] 时，连接失败只会静默返回 false，不会抛异常】，此时 try-catch 完全捕获不到错误。
立即学习“PHP免费学习笔记（深入）”；
测试完立即删掉这行 echo，避免上线后暴露调试信息。
表名映射失败导致查不到数据
方法一：用 $table 强制指定完整表名（推荐用于非标准命名）
在模型类中添加 protected $table = 'tp_user';，这会跳过所有前缀推导逻辑，直连指定表名。适用于表名为 cms_member、log_2024、report.users 等完全脱离命名规则的情况。
方法二：用 $name 配合全局 prefix（推荐用于标准前缀场景）
保持 config/database.php 中 'prefix' => 'tp_'，模型中设 protected $name = 'user';，TP 将自动拼出表名 tp_user。若同时设了 $table 和 $name，【$table 会完全覆盖 $name，且忽略 prefix 配置】，极易导致本地正常、线上查错表。
方法三：运行调试命令快速验证映射结果
执行 php think optimize:schema → 触发 schema 缓存重建；再在模型里加一行 echo (new UserModel())->getTable();，输出结果必须与数据库中真实表名（含前缀）完全一致，包括大小写。
字段映射异常的定位与修复
第一步：确认字段是否被下划线转驼峰机制“吃掉”
执行 $user = UserModel::find(1); var_dump($user->getData());，观察原始数据数组里的键名是 last_login_time 还是 lastLoginTime。若是前者，说明字段未触发转换；若是后者但 $user->lastLoginTime 为空，说明转换发生了但映射断在中间。
第二步：检查模型是否显式声明了 $table 或 $name
没设 $table（TP6）或 $name（TP5.1+）时，TP 会按类名 User→user 推导表名，一旦实际表是 tp_user，查询将静默命中空表，返回 null 或空集合，且无任何提示。
第三步：验证字段映射是否双向生效
若需将数据库字段 user_name 映射为模型属性 name，必须同时定义 protected $fieldMap = ['name' => 'user_name']; 并重写 getAttribute() 和 setAttribute() 方法，仅靠 getAttrNameAttr() 获取器只能加工读出后的值，无法解决原始字段捞取失败的问题。
第四步：确认 $fillable 填的是逻辑字段名而非数据库字段名
protected $fillable = ['name', 'status']; 是正确的；若写成 ['user_name', 'is_active']，create() 批量赋值时会直接过滤掉这些字段，导致数据写入为空。
