Yii2控制台命令无法执行，执行后仅返回命令列表

执行Yii2控制台命令时，无论输入具体命令（如php yii migrate/create test）还是其他子命令，始终返回全局命令列表，而非执行对应操作。示例返回内容：

The following commands are available:

- asset                        Allows you to combine and compress your JavaScript and CSS files.
    asset/compress (default)   Combines and compresses the asset files according to the given configuration.
    asset/template             Creates template of configuration file for [[actionCompress]].
...

以下是当前使用的核心文件：

yii控制台入口文件 #

#!/usr/bin/env php
<?php
/**
 * Yii console bootstrap file.
 */

defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'test');

require __DIR__ . '/vendor/autoload.php';
require __DIR__ . '/vendor/yiisoft/yii2/Yii.php';
require __DIR__ . '/common/config/bootstrap.php';
require __DIR__ . '/console/config/bootstrap.php';

$config = yii\helpers\ArrayHelper::merge(
    require __DIR__ . '/common/config/main.php',
    require __DIR__ . '/common/config/main-local.php',
    require __DIR__ . '/common/config/test.php',
    require __DIR__ . '/common/config/test-local.php',
    require __DIR__ . '/console/config/main.php',
    require __DIR__ . '/console/config/main-local.php',
    require __DIR__ . '/console/config/test.php',
    require __DIR__ . '/console/config/test-local.php'
);

$application = new yii\console\Application($config);
$exitCode = $application->run();
exit($exitCode);

console/config/main.php配置文件 #

<?php

$params = array_merge(
    require __DIR__ . '/../../common/config/params.php',
    require __DIR__ . '/../../common/config/params-local.php',
    require __DIR__ . '/params.php',
    require __DIR__ . '/params-local.php'
);

return [
    'id' => 'app-console',
    'basePath' => dirname(__DIR__),
    'bootstrap' => ['log'],
    'controllerNamespace' => 'console\controllers',
    'aliases' => [
        '@bower' => '@vendor/bower-asset',
        '@npm'   => '@vendor/npm-asset',
    ],
    'controllerMap' => [
        'fixture' => [
            'class' => \yii\console\controllers\FixtureController::class,
            'namespace' => 'common\fixtures',
        ],
    ],
    'components' => [
        'log' => [
            'targets' => [
                [
                    'class' => \yii\log\FileTarget::class,
                    'levels' => ['error', 'warning'],
                ],
            ],
        ],
    ],
    'params' => $params,
];

1. 核心原因：Migrate控制器未注册 #

Yii2控制台应用不会自动加载所有核心控制器，migrate这类核心命令需要在controllerMap中手动注册。当前配置仅注册了fixture控制器，缺少migrate的配置，导致系统无法识别该命令，最终返回全局命令列表。

解决方法：
在console/config/main.php的controllerMap数组中添加migrate控制器配置：

'controllerMap' => [
    'fixture' => [
        'class' => \yii\console\controllers\FixtureController::class,
        'namespace' => 'common\fixtures',
    ],
    // 新增migrate控制器配置
    'migrate' => [
        'class' => \yii\console\controllers\MigrateController::class,
        // 可选：指定迁移文件存储目录，默认是@console/migrations
        'migrationPath' => '@console/migrations',
    ],
],

2. 验证配置合并顺序 #

当前入口文件中配置合并顺序为：common环境配置 → console环境配置 → test环境配置。需确保test环境的配置文件（如console/config/test.php）未清空或覆盖controllerMap配置。如果test配置中存在'controllerMap' => []这类代码，会覆盖之前注册的控制器，导致命令无法识别。

检查方法：
打开console/config/test.php，确认其中的controllerMap是合并而非重置，例如：

// 正确写法：合并原有controllerMap
return [
    'controllerMap' => array_merge(
        require __DIR__ . '/main.php',
        [
            // 新增test环境专属控制器配置
        ]
    ),
];

而非直接重置为空数组。

3. 确认命令输入正确性 #

确保命令拼写无误，例如migrate未写成migrat，参数格式符合要求（如migrate/create后紧跟迁移名称）。

内容的提问来源于stack exchange，提问作者Regular User