ThinkPHP项目数据库迁移工具在不同环境的使用

thinkphp 6.0+ 迁移命令报错因未注册命令类，需确认安装topthink/think-migration、在config/console.php中注册\think\migration\command::class，并检查版本是否≥6.0.8；生产环境需显式指定数据库配置文件或确保.env生效；迁移文件须严格按时间戳命名，回滚时down()方法须幂等且先删外键再删表。

thinkphp项目数据库迁移工具在不同环境的使用_migration适配

Migration 命令在本地开发环境跑不通，报 `Class 'Think\Console\Command\Migrate\Status' not found`

这是 ThinkPHP 6.0+ 默认未启用迁移命令导致的——think-migration 扩展虽已安装，但命令类没注册进控制台。

实操建议：

确认已执行 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），而命令行不自动加载环境配置。

实操建议：

不要靠修改 .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 加载迁移类的顺序错乱，进而引发外键约束冲突或字段缺失。

实操建议：

迁移文件名必须严格按时间戳前缀命名，例如 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，导致整个回滚中断。

实操建议：

回滚操作不是“逆向执行”，而是按 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()，风险极高，仅限本地调试