Yii URL管理器异常：请求未正确路由至指定控制器/动作

已存在DeliveryController且包含actionCalculate方法，但POST请求/fargo/delivery/calculate未正确路由，反而匹配到根路径/对应的setting/index规则。以下是相关信息及可能的影响因素：

请求信息 #

POST /fargo/delivery/calculate

路由日志 #

Action ID: index
Controller ID: setting
Unique Action ID: setting/index // 应为 'delivery/calculate'
Request Uri: /fargo/delivery/calculate
Document Uri: /web/index.php

Yii web.php 路由配置 #

$config = array_merge_recursive($common, [
    ...
    'components' => [
        ...
        'urlManager' => [
            'enablePrettyUrl' => true,
            'showScriptName' => false,
            'rules' => [
                '/fargo/<controller:\w+>/<action:\w+>' => '/<controller>/<action>',
                '/' => '/setting/index',
                '/support' => '/site/support',
                '/callback/<uuid>/<groupId>' => '/callback/index',
            ],
        ],
    ],
    'on beforeAction' => function ($event) {
       ...
    }
]);

Nginx 配置 #

location ~* ^/fargo(.*)$ {
    root /var/www/fargo/;
    rewrite ^/fargo(.*)$ $1 break;
    
    try_files  $uri/ /web/index.php$is_args$args =404;

    fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
    fastcgi_index index.php;
    fastcgi_read_timeout 360;
    
    fastcgi_param  QUERY_STRING       $query_string;
    fastcgi_param  REQUEST_METHOD     $request_method;
    fastcgi_param  CONTENT_TYPE       $content_type;
    fastcgi_param  CONTENT_LENGTH     $content_length;
    fastcgi_param  SCRIPT_NAME        $fastcgi_script_name;
    fastcgi_param  REQUEST_URI        $request_uri;
    fastcgi_param  DOCUMENT_URI       $document_uri;
    fastcgi_param  DOCUMENT_ROOT      $document_root;
    fastcgi_param  SERVER_PROTOCOL    $server_protocol;
    fastcgi_param  HTTPS              $https if_not_empty;
    fastcgi_param  GATEWAY_INTERFACE  CGI/1.1;
    fastcgi_param  SERVER_SOFTWARE    nginx/$nginx_version;
    fastcgi_param  REMOTE_ADDR        $remote_addr;
    fastcgi_param  REMOTE_PORT        $remote_port;
    fastcgi_param  SERVER_ADDR        $server_addr;
    fastcgi_param  SERVER_PORT        $server_port;
    fastcgi_param  SERVER_NAME        $server_name;
    fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
    fastcgi_param  REDIRECT_STATUS    200;   
}

可能的影响因素 #

• 路由规则语法/顺序问题：Yii按规则定义顺序匹配，若第一条规则存在语法错误（如原始配置中曾出现的引号拼接错误），会直接失效，请求落到后续的/规则；另外若$common配置通过array_merge_recursive合并后打乱了规则顺序，也会导致优先匹配到默认规则。
• Nginx重写与URI传递冲突：Nginx通过rewrite将/fargo/delivery/calculate改为/delivery/calculate，但传递给Yii的REQUEST_URI仍是原始路径，两者不一致可能导致路由规则不匹配，需要确认Yii实际处理的是哪个URI。
• 控制器命名空间错误：DeliveryController的命名空间若不在Yii默认扫描路径（如app\controllers）下，框架无法找到控制器，会触发默认路由逻辑。
• beforeAction事件干扰：配置中的on beforeAction回调可能修改了请求参数或强制重定向，导致最终路由指向setting/index。
• 路由缓存未更新：Yii缓存了旧的路由规则，需清除runtime/cache目录下的缓存文件，确保新规则生效。
• 请求方法限制缺失：第一条路由规则未指定允许POST请求，若框架隐含了方法限制，POST请求会跳过该规则，落到默认路由。
• 正则匹配范围问题：虽然\w+能匹配delivery和calculate，但需确认控制器/方法名是否存在大小写不匹配（Yii默认控制器名首字母大写，对应小写路由是正确的），或包含\w以外的字符。

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