直接复制迁移文件到新项目执行大概率失败，因Laravel将迁移文件名中的时间戳作为唯一标识存入migrations表，与数据库状态比对；若时间戳冲突或表已存在但记录缺失，会报“Table already exists”或“This migration has already been run”。
直接复制迁移文件到新项目执行，大概率失败——不是语法错，而是 Laravel 迁移系统把 migration 文件当“不可变历史快照”，依赖其文件名里的时间戳和 migrations 表记录做状态比对。跳过生成、硬拷过去，php artisan migrate 会拒绝执行或报重复/缺失冲突。
为什么 copy + migrate 会报错 “Table already exists” 或 “This migration has already been run”
迁移文件名形如 2023_05_12_103045_create_users_table.php，Laravel 用其中的日期时间戳（2023_05_12_103045）作为唯一标识存入数据库 migrations 表的 batch 和 migration 字段。新项目若已执行过同名迁移（比如从旧项目导出的数据库含该记录），或该时间戳在新项目中已被其他迁移占用，就会触发冲突。
-
SQLSTATE[42S01]: Base table or view already exists：表已存在，但 migration 状态未记录 → Laravel 认为该迁移“没跑过”，强行执行建表语句 -
This migration has already been run：migrations表里已有同名记录 → Laravel 跳过，但实际表结构可能不一致（比如字段少一个） - 更隐蔽的是：旧项目用了
Schema::enableForeignKeyConstraints()，新项目没启用，up()中的外键操作静默失败
正确做法：用 php artisan migrate:refresh --seed 替代手动复制
新项目初始化阶段，不该靠“复制迁移文件”来同步结构。应让 Laravel 自己管理全量状态：
- 确保新项目
database/migrations/下只有原始框架自带迁移（如create_users_table）和你明确新增的业务迁移 - 删掉所有手工复制进来的迁移文件（哪怕内容一样）
- 运行
php artisan migrate:fresh --seed：它会先DROP所有表，再按文件名时间戳顺序重放全部迁移，最后执行 seeder - 如果只想重跑某几张表，用
php artisan migrate:fresh --path=database/migrations/2023_05_12_103045_create_users_table.php
必须手动复制时，怎么避免报错
极少数场景（如离线交付、CI 流水线隔离）真要复制迁移文件，需同步修正三处：
- 重命名文件：把原时间戳改成当前时间，例如
2026_08_17_120000_create_users_table.php（用date +"%Y_%m_%d_%H%M%S"生成） - 检查
up()方法：确认没调用Schema::dropIfExists('users')—— 新项目首次运行，删不存在的表会报错；改用if (!Schema::hasTable('users')) { ... } - 执行后立刻标记：若该迁移本意是“补结构而非初建”，跑完后手动补录记录到
migrations表：INSERT INTO migrations (migration, batch) VALUES ('2026_08_17_120000_create_users_table', 1);
最常被忽略的一点：迁移文件里的 PHP 版本兼容性
旧项目迁移中可能用了 $table->json('meta')->nullable();，而新项目 PHP 版本低于 7.3 或 MySQL 版本低于 5.7.8，该字段会创建失败。不要只看 Laravel 版本，得查 php -v 和 mysql --version 是否满足该迁移内每个字段类型的底层要求。尤其是 uuid()、timestampTz()、enum() 这类高版本才支持的语法，复制前务必 grep 检查。
