ThinkPHP模型查不到数据主因是表名映射错误：默认User类对应user表，若实际为tp_user需配置prefix；$name适配前缀规则，$table绕过前缀易出问题；文件名、类名、命名空间须严格一致；多前缀或跨库应显式设$table或$connection。
模型查不到数据，或者报“表不存在”，八成不是 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 都能改表名，但行为不同：前者只替换表名部分，仍受全局前缀和数据库配置影响；后者直接硬编码完整表名，会绕过前缀配置，容易上线后出问题。
- 推荐优先用
protected $name = 'user_profile';：适用于表名是tp_user_profile，但类叫UserProfile→ 自动映射成tp_user_profile，符合前缀逻辑 - 只有当表名完全跳脱规则（比如类叫
User，但表是cms_member）才用protected $table = 'cms_member'; - 千万别同时设
$name和$table：$table会覆盖$name，且忽略database.php里的prefix
模型文件名、类名、命名空间三者不一致导致 Class not found
ThinkPHP 6+ 用 PSR-4 自动加载，路径、文件名、类名、命名空间必须严格匹配，错一个字母或大小写就 Class not found。
立即学习“PHP免费学习笔记（深入）”；
- 类名是
User，文件必须叫User.php（不能是user.php或UserModel.php） - 文件路径是
app/model/User.php，命名空间就得是app\model（注意小写model，不是Model） - 控制器里必须
use app\model\User;，否则User::select()会被 PHP 解析为当前命名空间下的类 - Windows 下路径斜杠方向无关，但 Linux/容器环境对大小写敏感，
App/Model/User.php在服务器上大概率加载失败
多前缀或跨库场景下，别依赖自动映射
项目里混用 tp_、cms_、log_ 等多个前缀，或者要连另一个库的 report.users 表，自动映射立刻失效。
- 这种场景下，老老实实写
protected $table = 'cms_user';或protected $table = 'report.users'; - 如果只是换库不换表，用
protected $connection = 'report_db';更安全，它不干扰表名生成逻辑 - 测试时别只查一条：
User::find(1)成功不代表User::select()成功——后者走的是全表扫描，更容易暴露前缀或权限问题
最常被忽略的一点：$table 设了就等于放弃前缀配置，而很多团队上线前只测了单条查询，批量操作或关联查询时才突然发现数据对不上——映射问题往往不是“有没有”，而是“在哪一步悄悄失效了”。
