ThinkPHP 6.0+ 迁移命令报错因未注册命令类，需确认安装topthink/think-migration、在config/console.php中注册\think\migration\Command::class，并检查版本是否≥6.0.8；生产环境需显式指定数据库配置文件或确保.env生效；迁移文件须严格按时间戳命名，回滚时down()方法须幂等且先删外键再删表。
Migration 命令在本地开发环境跑不通，报 Class 'Think\Console\Command\Migrate\Status' not found
这是 ThinkPHP 6.0+ 默认未启用迁移命令导致的——think-migration 扩展虽已安装，但命令类没注册进控制台。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认已执行
composer require topthink/think-migration（注意不是thinkphp/migration） - 检查
config/console.php中是否包含'commands' => [ \think\migration\Command::class ]；若无，手动追加 - 运行
php think list，确认输出里有migrate:status、migrate:run等命令；没有则说明注册失败 - 某些低版本 TP6（如 v6.0.0~v6.0.7）存在命令注册 bug，建议升到
v6.0.8+或手动在app/command.php中 return 数组添加该命令类
生产环境执行 php think migrate:run 提示 SQLSTATE[HY000] [1045] Access denied
迁移命令默认读取 config/database.php 的 default 配置，但生产环境往往用的是独立配置文件（如 config/database_prod.php），而命令行不自动加载环境配置。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要靠修改
.env切换数据库配置——命令行下.env可能未生效，尤其当使用php-fpm或容器部署时 - 显式指定配置：运行
php think migrate:run --config=config/database_prod.php（路径需为相对于入口文件的相对路径） - 更稳妥的做法是统一用
.env，但确保命令行启动时加载了它：在think文件顶部加入Dotenv\Dotenv::createImmutable(__DIR__)->load();（TP6.1+ 已内置，老版本需补） - 验证方式：在命令中临时加一行
var_dump(config('database.hostname'));，看是否读到了预期值
同一份 migration 文件在 Windows 和 Linux 下生成的 SQL 不一致
核心原因是不同系统下 filemtime() 或 scandir() 返回的文件排序顺序不同，导致 migrate:run 加载迁移类的顺序错乱，进而引发外键约束冲突或字段缺失。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 迁移文件名必须严格按时间戳前缀命名，例如
20230101000000_create_users_table.php，禁止用xxx_v1.php这类随意命名 - 避免在单个 migration 文件中同时建表 + 加索引 + 插数据；拆成多个文件，靠文件名序号控制依赖顺序
- Linux 下若发现迁移跳过某些文件，检查文件权限：
chmod 644确保可读；Windows 下注意文件名大小写（如CreateUsersTable.php和createuserstable.php在 Linux 会被视为不同文件） - 上线前务必在目标环境（如测试服务器）用
php think migrate:status核对已执行列表，别只信本地记录
回滚 php think migrate:rollback 失败，提示 Base table or view not found
这不是语法错误，而是迁移逻辑本身破坏了依赖关系：比如某个 migration 先删了表 A，后删表 B，但表 B 的外键指向表 A —— MySQL 会拒绝删除表 A，导致整个回滚中断。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 回滚操作不是“逆向执行”，而是按
batch降序逐个调用down()方法，每个down()必须保证幂等且无强依赖 - 删表前加判断：
if ($this->schema->hasTable('users')) { $this->schema->drop('users'); } - 涉及外键的操作，务必在
down()中先删外键再删主表，顺序和up()相反；可用$this->schema->table('posts', function (Blueprint $table) { $table->dropForeign(['user_id']); }); - 慎用
php think migrate:reset——它会清空所有迁移记录并逐个执行down()，风险极高，仅限本地调试
down() 方法里那些看似安全的 dropTable()，一旦漏掉存在性判断或外键处理，在生产环境就是停服起点。 
