直接改模型里的$table属性即可，但必须拼写准确、值为字符串且大小写匹配；常见失效原因有属性名错误、非字符串值及大小写不一致；统一前缀用gettable()方法；迁移与模型不一致时优先检查命名对齐；动态切表慎用settable()。
直接改模型里的 $table 属性就行，但拼错、类型不对或大小写不匹配都会让修改失效——Laravel 只认这个 exact 名字，且必须是字符串。
为什么改了 $table 还在查 users 表？
最常见三个原因：
-
$table写成$tableName或$table_name—— Laravel 完全忽略，继续走默认复数推导（User→users） - 值不是字符串：比如
protected $table = env('USER_TABLE');，模型加载早于环境变量初始化，结果是null或false，最终 SQL 报SQLSTATE[42S02]: Base table or view not found - 大小写问题：Linux 下 MySQL 默认区分表名大小写，
protected $table = 'Users'和'users'可能指向不同物理表，尤其跨 Windows 开发、Linux 部署时容易漏检
多个模型要统一加前缀（如 wp_）怎么办？
别一个个改 $table，重写 getTable() 方法更可靠：
- 在基类模型里定义：
public function getTable() { return 'wp_' . parent::getTable(); } - 返回值必须是字符串，不能为
null，否则后续所有查询都崩 - 避免在
getTable()里调用未初始化的属性（如$this->connection可能还是null），也不建议做 DB 查询或配置读取 - 如果只对某类模型生效，加判断逻辑，比如：
if (str_starts_with($this->getModel(), 'Log')) { return $this->getModel() . '_archive'; }
迁移建的表名和模型 $table 不一致，该动哪边？
先别急着改代码。真实项目里，90% 的“不一致”其实是命名没对齐：
- 迁移建了
user_profiles，模型叫UserPreference？大概率是模型类名起错了，不是技术问题 - 真要动态切表（比如按租户分
tenant_1_users/tenant_2_users），慎用setTable()—— 它会污染 Eloquent 连接池缓存，在 Swoole 或 Octane 等长生命周期环境中，后续请求可能查错表 - 更安全的做法：用不同模型类分别映射不同表，或通过
on()切换已配置好的数据库连接（前提是config/database.php里已定义多个带不同前缀的连接）
真正容易被忽略的是：表名一旦硬编码进模型，就脱离了配置中心；多人协作时，DBA 改了迁移，后端忘了同步改模型，上线立刻报错。高频变动的表名，建议抽到配置项 + 构造函数赋值，哪怕多两行，也比排查二十分钟实在。
