最常见原因是属性名写错（如$tablename）、非字符串值（如env()调用）或大小写不匹配；gettable()适用于多模型统一前缀/后缀等场景，需确保返回字符串且避免早期依赖未初始化属性。
直接在模型里写 $table 属性就行，Laravel 只认这个固定名字，拼错或加下划线都无效。
为什么改了 $table 还是查 users 表？
最常见原因是属性名写错了：比如写成 $tableName、$table_name 或 protected static $table —— Laravel 只读实例属性 $table，且必须是 public/protected 的非静态字段。
另一个隐蔽问题是值不是字符串：protected $table = env('USER_TABLE'); 会报错，因为模型加载早于环境变量解析；要用构造函数或静态方法延迟处理。
还要注意大小写：MySQL 在 Linux 下表名区分大小写，protected $table = 'Users' 和 'users' 可能指向不同表（尤其跨平台开发时）。
getTable() 方法适合什么场景？
当多个模型共享同一套命名规则时，比如全部加 wp_ 前缀、或日志类模型统一后缀 _archive，重写 getTable() 比逐个写 $table 更干净。
但要注意两点：
-
getTable()在模型初始化极早期调用，$this->connection可能还是null，别在里面访问连接配置 - 返回值必须是字符串，返回
null或数组会导致 SQL 报错SQLSTATE[42S02]: Base table or view not found
示例（基类中）：
public function getTable()
{
return 'wp_' . parent::getTable();
}
迁移文件和模型表名不一致怎么办？
先别急着改模型。检查迁移文件建的表名是否真和业务需求匹配——比如迁移建了 user_profiles，但模型叫 UserPreference，大概率是模型命名没对齐，而不是技术问题。
如果确实要动态切表（如按租户分表），setTable() 能用，但得小心：它会污染 Eloquent 连接池里的表名缓存，尤其在长生命周期进程（如 Swoole）中可能引发后续查询错表。
更安全的做法是：用不同模型类分别映射不同表，或通过 on() 切换连接（前提是已配好多个带不同前缀的数据库连接）。
真正容易被忽略的是：表名一旦硬编码进模型，就脱离了配置中心管理；多人协作时，表名变更若只改迁移不改模型，或只改模型不通知 DBA，上线后立刻报错。建议把高频变动的表名抽到配置项 + 构造函数赋值，哪怕多写两行，也比排查 20 分钟来得实在。
