TP5.0升级TP5.1迁移失败主因是路径、类继承、模型调用、时间字段语法及回滚清理差异：需改migration目录为database/migrate、继承think\migration\Migrator、禁用模型操作、显式声明时间戳、down方法加表/字段存在性判断。
ThinkPHP 5.0 升级到 5.1 后，数据库模型迁移本身不涉及框架底层结构大改，但实际操作中常因配置、语法、加载机制等细节差异导致失败。重点不是“能不能迁”，而是“哪些地方一动就报错”。
迁移命令执行失败：类找不到或目录路径错乱
TP5.0 默认用 topthink/think-migration:1.*，而 TP5.1 推荐用新版（2.x 或更高），两者生成的迁移文件基类不同：
- TP5.0 的迁移类继承
Phinx\Migration\AbstractMigration，文件放在database/migrations/ - TP5.1 官方封装版默认识别
think\migration\Migrator，且迁移目录为database/migrate/（注意是 migrate，不是 migrations） - 若沿用 TP5.0 的迁移文件，需手动改类名和命名空间，并确保
composer dump-autoload重刷自动加载 - 检查
config/migration.php是否存在并正确配置了'path' => 'database/migrate'，否则php think migrate:run会静默跳过所有文件
up()/down() 方法中调用模型直接报错
TP5.1 在命令行环境下初始化较早，模型类依赖的容器、连接配置可能未完全加载：
- 禁止在迁移文件中写
UserModel::create()或Db::name('user')->select()（Db类在部分版本中也不稳定） - 统一使用
$this->execute('INSERT INTO ...')或原生 PDO 操作填充测试数据 - 如需复用业务逻辑，应把数据构造逻辑抽成独立函数，放在
database/seeds/下用seed:run单独执行
时间戳字段迁移失败：MySQL 8.0+ strict 模式报错
TP5.0 项目常运行在 MySQL 5.7，升级 TP5.1 后若同步升级了 MySQL 版本，迁移中隐式定义的时间字段会触发错误：
立即学习“PHP免费学习笔记（深入）”；
-
$table->datetime('updated_at')→ 必须显式补->useCurrent()->useCurrentOnUpdate() -
$table->timestamp('created_at')→ 改为$table->timestamp('created_at')->useCurrent() - 字段设默认值时，避免
default(0)，改用default(null)或nullable()配合useCurrent() - 外键字段类型必须严格一致（如主表
id是unsignedBigInteger，从表关联字段也必须同类型）
已执行迁移回滚后重建表失败
TP5.1 的 migrate:rollback 不会自动清理已创建的表，若 down() 方法没写全或漏掉索引/外键，再次 migrate:run 就会卡住：
-
down()中删除表前，先检查是否存在：if ($this->hasTable('user')) { $this->dropTable('user'); } - 删字段前加判断：
if ($this->hasColumn('user', 'email')) { $this->table('user')->removeColumn('email')->update(); } - 不要修改已执行过的迁移文件——哪怕只是加个空格。修复逻辑应新建一个迁移文件，例如
20240316000000_fix_user_email_nullable.php
