TP6数据库迁移报错多因环境配置、扩展版本或路径规则不一致，按顺序排查这三类问题可解决90%故障：先确认扩展安装注册正确，再核对迁移文件命名与路径规范，最后检查自动加载及状态表一致性。
TP6数据库迁移报错，多数不是代码写错了，而是环境配置、扩展版本或路径规则没对齐。只要按顺序排查这三块，90%的问题当场解决。
命令不存在？先确认扩展装对+注册到位
执行 php think migrate:install 报 “Command not defined”，说明迁移命令根本没加载进来：
- 检查 composer.json 是否真有
"topthink/think-migration": "^3.0"（TP6.0.8+）或"^2.0"（TP6.0.0–6.0.7），注意不是think-migrations或think-phinx - 打开 config/console.php，确认
'commands'数组里包含'\think\migration\Command::class'；没有就手动加进去 - 上线部署时若用了
composer install --no-dev，要确认该包在require而非require-dev里——它必须在生产环境也存在 - 运行 php think list，看到
migrate:install和migrate:run才算真正就位
“No migrations to run” 却有文件？命名和路径必须严丝合缝
迁移文件写了，但 php think migrate:run 说没东西可跑，问题几乎全出在扫描规则上：
- 文件必须放在 database/migrations/ 目录下（拼写是
migrations，不是migrateions或migration） - 文件名必须是 14位时间戳_描述.php 格式，例如
20260827112000_create_users_table.php；用php think migrate:create Users生成最保险 - 类中必须实现
change()方法（不是up()/down()），且方法体不能为空 - 如果改过文件名或移动过位置，记得清缓存：
composer dump-autoload -o
初始化失败或类找不到？自动加载和依赖链断了
报 Class 'PhinxConsoleCommandInit' not found 或类似错误，本质是 Phinx 底层类没加载成功：
- 先执行
composer dump-autoload -o强制刷新自动加载映射 - 检查入口文件
think是否引入了vendor/autoload.php；某些定制项目会跳过这步 - 临时加一行
var_dump(class_exists('\Phinx\Console\Command\Init'));验证 Phinx 是否可用 - 如果仍不行，可能是框架版本兼容问题：TP6.0.0–6.0.7 推荐升到 TP6.0.8+，避免已知的自动加载 Bug
迁移执行一半中断？状态表损坏需手动清理
中途 Ctrl+C 或报错退出后，再跑 migrate:run 可能卡住或跳过，因为 think_migrations 表记录不一致：
- 查表：
SELECT * FROM think_migrations;，看最后一条是否对应你刚写的迁移文件名 - 若多了一条未完成的记录，直接删掉它；若缺了某条，可手动插入（格式参考其他行，
version字段填文件名前缀，如20260827112000） - 不想手动操作，也可清空整张表再重跑
migrate:install，前提是本地开发环境且无线上数据风险
