Router Scope致URL构建异常：API前缀显示不一致问题咨询

你遇到的情况核心是路由匹配优先级和路由定义范围的问题：

1. 你的/api作用域里的resources('Invoices')应该包含了index路由（默认资源路由会自动生成，或者你手动指定了only => ['index']），但没有包含add路由；
2. 路由定义的顺序导致反向生成URL时，CakePHP优先匹配到了/api作用域下的index路由，而add因为/api里没有对应路由，只能匹配默认作用域的路由。

下面几种方法都能帮你生成不带/api前缀的/invoices链接：

方法1：指定路由名称（最可靠） #

先在默认作用域里给Invoices的index路由起一个明确的名称：

// 在默认的根作用域配置中
Router::scope('/', function (RouteBuilder $routes) {
    // 其他路由配置...
    $routes->resources('Invoices', [
        'names' => [
            'index' => 'invoices_index'
        ]
    ]);
});

然后生成链接时，通过route参数指定使用这个命名路由：

<?= $this->Html->link(
    '<i class="fi-book"> ' . __('Invoices') . '</i>',
    [
        'route' => 'invoices_index',
        'plugin' => false,
        'prefix' => false,
        'controller' => 'invoices',
        'action' => 'index'
    ],
    ['escape' => false]
) ?>

方法2：强制排除扩展名 #

因为你的/api作用域设置了setExtensions(['json'])，可以在生成URL时明确指定不需要扩展名，这样CakePHP会跳过/api的路由，匹配默认作用域的路由：

<?= $this->Html->link(
    '<i class="fi-book"> ' . __('Invoices') . '</i>',
    [
        'plugin' => false,
        'prefix' => false,
        'controller' => 'invoices',
        'action' => 'index',
        '_ext' => false
    ],
    ['escape' => false]
) ?>

方法3：调整路由定义顺序 #

把默认作用域的Invoices路由放在/api作用域之前定义，这样反向生成URL时会优先匹配默认路由：

// 先定义默认的Invoices资源路由
Router::scope('/', function (RouteBuilder $routes) {
    $routes->resources('Invoices');
    // 其他默认路由...
});

// 再定义API作用域
Router::scope('/api', function (RouteBuilder $routes) {
    $routes->setExtensions(['json']);
    $routes->resources('Invoices');
});

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