如何正确设置ThinkPHP模型表名以避免数据表映射失败？

本文共计996个文字，预计阅读时间需要4分钟。

模型查不到数据，或者报错表不存在，并非SQL写错，而是表名映射没对上——ThinkPHP的模型和表名绑定是靠命名规则，不是配置、注释或手动指定，这点必须先确认清楚。

为什么 User::select() 返回空数组？先检查表名映射是否生效

默认情况下，User 类对应表名 user（小写），如果数据库里实际是 tp_user，而你又没在 database.php 里配 'prefix' => 'tp_'，那就会查 user 表，自然为空。

• 打开 config/database.php，确认 'prefix' 配置值是否与真实表前缀一致（比如 'tp_'）
• 检查数据库中真实表名：是 tp_user 还是 user？是 tp_user_profile 还是 userprofile？大小写、下划线都影响映射
• 运行 php think optimize:schema 或临时加一行调试：echo (new \app\model\User())->getTable();，看输出是不是你预期的表名

表名不遵循驼峰转下划线规则时，该用 $name 还是 $table？

$name 和 $table 都能改表名，但行为不同：前者只替换表名部分，仍受全局前缀和数据库配置影响；后者直接硬编码完整表名，会绕过前缀配置，容易上线后出问题。