CakePHP 3 中Phinx迁移CLI执行时抛出参数异常求助

我之前也踩过这个一模一样的坑——直接删库不回滚，连Phinx用来追踪迁移历史的日志表也给干掉了，结果整个迁移命令直接炸锅。这个Argument 2 passed to Phinx\Migration\Manager::__construct异常，本质就是Phinx找不到它依赖的状态记录表，导致初始化管理器时参数不合法。下面是快速修复的步骤：

1. 手动重建Phinx迁移日志表 #

Phinx全靠这个表记录哪些迁移已经执行过，你把它删了之后，Phinx直接就懵了。首先得确定你的日志表名：

• CakePHP 3集成Phinx时，默认表名是migrations（可以去config/app.php里的Migration配置段确认）
• 原生Phinx默认是phinxlog

以MySQL为例，执行以下SQL重建表：

CREATE TABLE IF NOT EXISTS `migrations` (
    `version` bigint(20) NOT NULL,
    `migration_name` varchar(100) DEFAULT NULL,
    `start_time` timestamp NULL DEFAULT NULL,
    `end_time` timestamp NULL DEFAULT NULL,
    `breakpoint` tinyint(1) NOT NULL DEFAULT '0',
    PRIMARY KEY (`version`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

如果用的是PostgreSQL或SQLite，调整对应字段类型即可（比如PostgreSQL把timestamp换成timestamptz）。

2. 验证迁移命令恢复正常 #

表建好后，先跑一下状态命令确认异常是否消失：

bin/cake migrations status

这时候应该不会再抛出初始化异常了，会显示所有迁移都处于down（未执行）状态。

3. 重新执行所有迁移 #

现在就可以正常执行迁移命令，从头构建数据库了：

bin/cake migrations migrate

如果有种子数据需要导入，再加--seed参数即可。

避坑提醒 #

• 以后千万别直接删表！要回滚到初始状态，用bin/cake migrations rollback -t 0，Phinx会正确更新日志表，不会搞出这种幺蛾子。
• 如果要修改已执行过的迁移文件，先回滚到该迁移之前的版本（比如rollback -t [目标版本号]），修改后再重新migrate，避免出现版本冲突。

内容的提问来源于stack exchange，提问作者Zlatan Omerović