模型生成后必须检查表名、主键、时间戳三件事：设 $table 指定真实表名，$primaryKey 指定主键字段，$timestamps=false 关闭自动时间戳。
直接用 php artisan make:model 生成，再根据表名、字段、关联等实际结构补配置，别指望默认推导全对。
模型文件生成后必须检查的三件事
Artisan 命令生成的模型只是骨架，Laravel 默认按类名复数小写推导表名（User → users），但真实项目里几乎总会打破这个约定：
- 旧库表名是
user_info或tbl_user？立刻在模型里加protected $table = 'user_info';—— 写成$tableName或$table_name都无效 - 主键不是
id？比如是uid或article_id，得补protected $primaryKey = 'uid'; - 不需要自动维护
created_at/updated_at？关掉：public $timestamps = false;，否则插入时会因字段不存在报错
批量赋值字段必须显式声明 $fillable 或 $guarded
没声明 $fillable 就调 create() 或 update()，字段直接被忽略，不报错也不提示，查半天发现数据没进去——这是最常踩的静默坑：
- 只允许填
title和content：protected $fillable = ['title', 'content']; - 想“除了 password 全都可填”，用
$guarded = ['password'];，但注意它和$fillable互斥，不能共存 - 别把字段名拼错，比如
'is_active'写成'isactive'，Eloquent 不校验，赋值时就丢掉了
关联方法写错，with() 就是摆设
with('author') 返回空或报错，大概率不是语法问题，而是外键没对齐：
-
belongsTo必须写在外键所在模型里：如果posts表有author_id字段，那就在Post模型里写belongsTo(User::class, 'author_id') -
hasMany的第二参数是外键名，不是本地键：hasMany(Comment::class, 'post_id')，不是'id' - 中间表命名不规范？
belongsToMany(Role::class, 'user_role', 'user_id', 'role_id')四个参数一个都不能少，漏了就查不到数据
类型转换（$casts）依赖数据库字段真实类型
$casts = ['is_active' => 'boolean'] 看着很爽，但底层会把 "1" 转成 true 再存进数据库——如果字段类型是 VARCHAR，存进去就是字符串 "1"；如果是 TINYINT(1)，才能真正存成数字 1：
-
json字段必须配$casts = ['meta' => 'array']，且数据库类型得是JSON（MySQL 5.7+）或TEXT（低版本 fallback） -
$casts里写了不存在的字段名，Eloquent 不警告，取值时直接返回null，很难排查 - 前端传
"is_active": "1"，后端想转布尔又怕存错，优先改数据库字段为TINYINT(1)，再配'boolean'cast
模型不是写完就完事的代码块，它是数据库结构在 PHP 层的镜像。表名、主键、时间戳、填充白名单、类型转换、关联外键——每个配置项背后都对应着真实的数据约束，漏掉一个，运行时就可能静默失败或查不到数据。
