模块内动作路由问题：Admin模块Test动作访问返回404

首先，先明确你访问actionTest的正确URL格式应该是：http://backend/admin/default/test

为什么actionIndex可以通过http://backend/admin直接访问？因为Yii框架里模块的默认控制器是DefaultController，默认动作是index，所以可以省略控制器和动作名。但test不是默认动作，必须完整指定路由路径才能被正确解析。

接下来，我整理了几个最可能导致404的原因及排查方案：

1. URL路由规则缺失 #

检查你的backend应用路由配置（通常在backend/config/main.php的urlManager节点），如果开启了URL美化（enablePrettyUrl设为true），要确保规则覆盖了模块的完整路由：

'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
    'rules' => [
        // 通用模块路由规则，适配所有模块的控制器和动作
        '<module:\w+>/<controller:\w+>/<action:\w+>' => '<module>/<controller>/<action>',
        // 针对Admin模块的简化规则（可选）
        'admin/<controller:\w+>/<action:\w+>' => 'admin/<controller>/<action>',
        // 对应你能正常访问的首页路由
        'admin' => 'admin/default/index',
    ],
],

如果缺少模块+控制器+动作的匹配规则，Yii无法解析admin/default/test这类URL，自然会返回404。

2. Admin模块未正确注册 #

确认你的backend应用已经在配置中注册了Admin模块，检查backend/config/main.php的modules数组：

'modules' => [
    'admin' => [
        'class' => 'backend\modules\admin\Module',
        // 其他模块相关配置（如布局、权限等）
    ],
],

如果模块未注册，即使actionIndex可能因默认规则巧合访问到，非默认动作必然会触发404。

3. 控制器类与文件路径匹配问题 #

再核对你的DefaultController类命名和文件路径是否严格一致：

namespace backend\modules\admin\controllers;

use yii\web\Controller;

class DefaultController extends Controller
{
    public function actionIndex()
    {
        return $this->render('index');
    }

    public function actionTest()
    {
        echo "test";
    }
}

文件必须放在backend/modules/admin/controllers/DefaultController.php路径下，注意Linux系统区分文件名大小写，建议保持类名和文件名完全一致（首字母大写）。

4. 访问控制权限限制 #

如果你的Admin模块启用了AccessControl过滤器，检查是否将test动作加入了允许访问的列表：

public function behaviors()
{
    return array_merge(
        parent::behaviors(),
        [
            'access' => [
                'class' => \yii\filters\AccessControl::class,
                'rules' => [
                    [
                        'actions' => ['index', 'test'], // 确保test动作在允许范围内
                        'allow' => true,
                        'roles' => ['@'], // 根据实际权限调整
                    ],
                ],
            ],
        ]
    );
}

如果test动作不在允许列表中，部分配置下会返回404（而非403权限错误），需要确认这一点。

建议先尝试直接访问http://backend/admin/default/test，如果仍返回404，按照上面的步骤逐一排查配置问题即可。

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