ThinkPHP6升到8后迁移报错是因路径、类继承和命令注册三处契约变更；需换装^5.0版think-migration，重置migration文件位置与命名，修正类继承及MySQL 8.0 strict兼容写法，并重建迁移状态表。
ThinkPHP6升到8后执行数据库迁移命令报错、卡住或提示Class not found，说明迁移机制未与TP8新结构对齐——不是SQL写错了，而是迁移文件位置、类继承、命令注册这三处底层契约已变更。
确认迁移扩展是否适配TP8
TP8不再兼容旧版think-migration，必须换用专为TP8设计的迁移驱动。执行composer require topthink/think-migration:^5.0，注意版本号必须是^5.0，^4.0及以下在TP8中会因Container调用方式变更而静默失效。
安装完成后运行php think list | grep migrate，若输出为空，说明命令未注册成功——这一步失败，后续所有迁移操作都无效。
【务必删除vendor/topthink/think-migration目录后重装】——残留的旧版本类文件会干扰自动加载，导致migrate:run命令根本无法识别。
立即学习“PHP免费学习笔记（深入）”；
迁移文件路径与命名必须重置
TP8默认只扫描database/migrations/目录（不是migrate），且文件名必须严格为14位时间戳+下划线+小写字母命名，例如20260806123456_create_user_table.php。
手动将原TP6项目的database/migrate/下所有文件剪切到database/migrations/，然后逐个重命名：去掉原有前缀，用当前时间生成新时间戳（可用date +%Y%m%d%H%M%S获取）→ 保留原逻辑名但转为小写+下划线，如CreateUserTable → create_user_table。
打开每个文件，检查类名是否与文件名一致（不含扩展名）、首字母大写，且继承自think\migration\Migrator；若仍继承Phinx\Migration\AbstractMigration，迁移将完全跳过执行。
修复up()与down()中的MySQL 8.0 strict模式兼容问题
TP8默认启用严格模式校验，而TP6迁移中常省略字段约束声明，升级后建表直接报错Invalid default value for 'updated_at'。
方法一：在up()中所有datetime字段后显式追加->useCurrent()或->nullable()，例如：
$table->datetime('created_at')->useCurrent();
方法二：对timestamp类型字段统一改用->useCurrent()->useCurrentOnUpdate()，避免MySQL 8.0因无默认值拒绝建表。
down()中对应字段必须还原：删字段前先删索引，dropTable前先检查表是否存在——否则回滚时遇到已删表会中断整个迁移链。
重新初始化迁移状态表并强制重跑
第一步：清空原TP6生成的think_migration表（如有），执行php think migrate:install重建TP8专用元数据表。
第二步：运行php think migrate:status确认所有迁移文件状态为down，若显示up但实际未执行，说明状态记录错乱。
第三步：执行php think migrate:reset → php think migrate:refresh，强制清空所有已应用迁移并从头重跑。这一步会删掉你数据库里所有由迁移创建的表，请确保生产环境已备份。
