ThinkPHP模型类名默认映射表名规则是：驼峰转小写下划线并加前缀，如UserOrderLog→tp_user_order_log；缩写或非法字符会导致错误推导，推荐显式定义$table属性。
模型类名默认映射的表名规则是什么
ThinkPHP 的 Model 类会根据类名自动推导数据表名：把驼峰命名（PascalCase）转成小写下划线（snake_case），再加默认前缀。比如 UserOrderLog → user_order_log，如果配置了 prefix 为 tp_，最终查的是 tp_user_order_log。
常见错误现象是报错：Table 'dbname.tp_userorderlog' doesn't exist——它没加下划线，说明类名被当成了全小写连写处理，典型原因是类名里有缩写（如 URLParser → 被转成 urlparser 而非 u_r_l_parser），或者用了非法字符、数字开头等。
- ThinkPHP 6 默认使用
think\Model的getTableName()方法推导，不依赖数据库实际是否存在 - 如果类名含大写字母紧挨着（如
APIConfig），会变成a_p_i_config或直接apiconfig，取决于版本和配置 - 推荐做法：不用猜规则，直接在模型里显式声明
$table属性
手动指定表名的两种可靠方式
最稳妥的做法是在模型类中固定写死表名，避免任何推导歧义。
- 在模型类顶部定义
protected $table = 'my_custom_table';（TP6）
- 或者重写
getTableName() 方法（TP5/TP6 都支持），例如：public function getTableName()
{
return 'sys_user_profile';
}
- TP6 中还可通过构造时传参：
new UserModel(['table' => 'sys_user_profile'])，但仅适用于临时覆盖，不适合全局约定
protected $table = 'my_custom_table';（TP6）getTableName() 方法（TP5/TP6 都支持），例如：public function getTableName()
{
return 'sys_user_profile';
}new UserModel(['table' => 'sys_user_profile'])，但仅适用于临时覆盖，不适合全局约定注意：如果同时设置了 $table 和 $name（旧版用的属性），$table 优先级更高；$name 只在没设 $table 时参与推导。
为什么改了类名或表名后还是报“表不存在”
不是代码没生效，而是缓存或连接层出了问题。
- 模型类被 Swoole 或 FPM 进程常驻后，修改类文件可能不热更，需重启服务
- ThinkPHP 的查询构建器会缓存表结构（
__TABLE_SCHEMA__），尤其开启 schema_cache_type 时，删掉 runtime/schema/ 下对应文件即可
- 数据库连接指向了错误库名，检查
database.php 中的 database 配置项是否拼写正确
- 表名大小写敏感：Linux 下 MySQL 默认区分大小写，
MyTable 和 mytable 是两张表，而模型里写的 $table = 'MyTable' 可能查不到
关联查询时表名没对上怎么办
关联方法（如 belongsTo、hasMany）内部也会自动推导被关联模型的表名，一旦主模型设了 $table，被关联模型也得同步设，否则关联 SQL 里会出现两个不同表名。
- 关联定义里可显式传入表名参数，例如：
belongsTo(User::class, 'user_id', 'id', [], 'LEFT')->setEagerlyType(0)->table('sys_user')
- 更推荐统一在被关联模型里设好
$table，保持逻辑内聚
- 使用
Db::name('sys_user') 直接查可以绕过模型映射，但失去模型事件、自动时间戳等能力，慎用
__TABLE_SCHEMA__），尤其开启 schema_cache_type 时，删掉 runtime/schema/ 下对应文件即可database.php 中的 database 配置项是否拼写正确MyTable 和 mytable 是两张表，而模型里写的 $table = 'MyTable' 可能查不到belongsTo、hasMany）内部也会自动推导被关联模型的表名，一旦主模型设了 $table，被关联模型也得同步设，否则关联 SQL 里会出现两个不同表名。
- 关联定义里可显式传入表名参数，例如：
belongsTo(User::class, 'user_id', 'id', [], 'LEFT')->setEagerlyType(0)->table('sys_user') - 更推荐统一在被关联模型里设好
$table，保持逻辑内聚 - 使用
Db::name('sys_user')直接查可以绕过模型映射，但失去模型事件、自动时间戳等能力，慎用
表名映射看着简单，真正卡住人的往往不是规则本身，而是推导链路上某一处缓存没清、配置没生效、或大小写混用后根本没报错只是查空了。
