ThinkPHP 的数据库迁移不是开箱即用的功能，不装扩展、不注册命令、不初始化状态表，php think migrate:run 就永远报错或静默失败。
Command "migrate:run" is not defined 怎么办
这不是拼写错误，是命令根本没加载进系统。TP6.0.8+ 必须用 topthink/think-migration:^3.0，旧版 TP6.0.0–6.0.7 只能用 ^2.0；装完后必须检查 config/console.php 中的 'commands' 数组是否包含 '\think\migration\Command::class'；最后执行 php think list，确认输出里有 migrate:install 和 migrate:run —— 没这俩，别往下走。
- 上线部署时若用了
composer install --no-dev，而该包在require-dev里，命令会直接消失（生产环境也得留着它） - 某些定制项目禁用了 Composer 自动加载，需确认
vendor/autoload.php在入口文件中被引入 -
composer dump-autoload -o强制刷新映射，比删 vendor 重装快得多
No migrations to run 却明明有文件
这个提示实际意思是“扫描不到合法迁移文件”，路径、命名、类定义三者必须严丝合缝。
- 迁移文件必须放在
database/migrations/（注意是migrations，不是migrate或migration） - 文件名必须为 14 位时间戳开头：
YYYYMMDDHHIISS_*.php（如20260515000000_add_phone_to_user.php），Windows 下复制粘贴易带 BOM 或不可见空格 - 类名必须与下划线后部分一致（如上例对应
AddPhoneToUser），且继承think\migration\Migrator - 改过
config/migration.php的'path'配置？清掉runtime/cache/，否则缓存路径仍生效
up() 加了字段，rollback 后还在
这不是框架 bug，是你没写 down()，或者写了但 SQL 不兼容目标数据库。
立即学习“PHP免费学习笔记（深入）”；
-
down()是强制要求，不是可选项；up()调addColumn('phone')，down()就得显式写dropColumn('phone') - MySQL 5.7+ 的 MyISAM 引擎不支持
DROP COLUMN，执行会报错但不中断流程，字段就“残留”了 - 避免在
up()里用Db::insert()填数据——回滚不会删，结构和数据就脱节了；这类逻辑应交给seed命令单独管理 - 本地调试务必用
php think migrate:rollback --step=1单步验证down()是否真生效
能不能在事件里触发迁移
不能。迁移是部署期行为，事件运行在 HTTP 请求周期中，没有命令行环境，也没有 $input 和 $output 实例。
- 在
app_init或db_query里调php think migrate:run会直接报Call to undefined function - 手动 new
\think\migration\Command会因缺少输入输出对象崩溃 - 真要实现「点击按钮初始化系统」，应把建表逻辑抽成 Service，在控制器中判断关键表是否存在，再调用封装好的初始化方法
- 迁移文件里只放 DDL（
createTable、addColumn），别触发事件；监听器若依赖 Request/Session，命令行环境下直接 fatal error
最常被忽略的是：迁移状态表（think_migration）必须由 php think migrate:install 显式创建，而不是靠第一次 run 自动补全；一旦跳过这步，所有后续操作都只是空转。
