Laravel迁移需严格遵循命名规范、依赖顺序和环境配置三者对齐，否则php artisan migrate会静默失败或报错Class not found；创建迁移应使用小写+下划线表名、显式动作意图命名，字段定义需链式添加约束，timestamps()默认添加created_at/updated_at，排查失败须查migrations表与日志，rollback仅撤回最后一次batch，reset会清空所有记录并执行down()，已提交的migration严禁修改，须新增修复迁移。
迁移文件不是“写完就能跑”，必须确保命名规范、依赖顺序和环境配置三者对齐，否则 php artisan migrate 会静默失败或报错 Class not found。
如何正确创建 migration 文件（含表名、字段与时间戳）
Laravel 的 make:migration 命令本身不校验表名合法性，但后续执行时若表名含非法字符（如大写字母、短横线），MySQL 会拒绝建表；推荐全部小写 + 下划线，并在命令中显式体现动作意图。
- 创建用户表迁移：
php artisan make:migration create_users_table（注意末尾_table是约定，非强制但强烈建议） - 添加字段时别直接写
$table->string('name')就完事——如果字段要索引或唯一，得立刻加链式调用：$table->string('email')->unique() - 时间戳字段默认由
$table->timestamps()添加，它等价于created_at和updated_at两个nullableTimestamps()字段；若不需要自动更新，改用$table->timestamp('published_at')->useCurrent();
运行 migrate 时常见的 3 种失败场景及应对
错误往往不出现在命令行输出里，而是藏在 migrations 表或数据库日志中。重点排查以下三类：
-
SQLSTATE[42000]: Syntax error or access violation：通常是字段类型不兼容，比如在 SQLite 中用了json()（Laravel 9+ 才支持），应降级为text()并手动解析 -
Base table or view not found：说明up()方法里写了foreignIdFor(User::class)，但users表迁移还没执行——迁移文件名前缀（时间戳）决定执行顺序，务必让被依赖的表迁移更早生成 -
Class 'CreatePostsTable' not found：文件名和类名不一致（例如文件是create_post_table.php，但类声明为class CreatePostsTable），Laravel 严格按文件名映射类名，大小写和复数都必须完全匹配
rollback 与 reset 的区别和危险操作预警
php artisan migrate:rollback 只撤回最后一次 batch（即一组同时运行的迁移），而 php artisan migrate:reset 会清空所有已记录的迁移记录并逐个执行 down() ——但前提是每个 down() 方法都真正实现了逆向逻辑。
- 不要在生产环境直接用
reset，哪怕你刚确认过代码；因为某些down()会删数据（如$table->dropColumn('api_token')不会恢复旧值） - 如果某次迁移只改了字段长度（
$table->string('title', 100)→255），down()写成$table->string('title', 100)看似合理，但 MySQL 实际执行的是MODIFY COLUMN，可能截断已有超长数据 - 安全做法：对结构变更类迁移，
down()应优先考虑重命名字段或新增兼容字段，而非硬性缩容
public function up(Blueprint $table)
{
$table->string('title', 255)->change(); // Laravel 8+ 支持 change()，但需开启 doctrine/dbal
}
public function down(Blueprint $table)
{
// ❌ 危险：可能丢数据
// $table->string('title', 100)->change();
// ✅ 更稳妥：先加新字段，再迁移数据，最后删旧字段（分多步迁移）
}
最常被忽略的一点：migration 文件一旦提交到团队仓库，就视为“已发布”，不能再修改其 up() 或 down() 内容。需要调整时，必须新建一个 migration 文件来修复，而不是编辑旧文件——因为其他成员本地的 migrations 表里已记录该文件为“已完成”。
