Laravel 8路由名称重复叠加前缀访问返回404问题求助

问题本质 #

该问题和路由缓存无关，核心原因是嵌套路由组的name前缀被重复拼接：Laravel 路由的name()配置支持层级继承，外层路由组设置的name前缀会自动拼接到所有内层子路由、子分组的name值前面，只要外层已经配置了crm.merchant.相关前缀，内层路由又重复写了全路径的name，就会出现你看到的前缀重复叠加问题。

排查步骤 #

• 全局检索所有路由配置文件（包含routes/目录下的web.php、自定义路由文件，以及第三方服务提供者中注册的路由），查找包裹问题路由的所有外层Route::group()、Route::prefix()、Route::middleware()、Route::resource()配置，重点看这些外层结构有没有调用->name('crm.')、->name('crm.merchant.')之类的前缀配置。
• 重点排查多层分组重复加前缀的场景：比如最外层crm模块分组已经加了->name('crm.')，中间merchant模块分组又加了->name('merchant.')，两层已经会自动给子路由拼接上crm.merchant.前缀，这时候子路由如果写全->name('crm.merchant.klaim')，就会生成重复的路由名。
• 可以执行php artisan route:list --name=crm.merchant反向定位路由注册的文件位置，快速找到重复加前缀的分组配置。

修复方案 #

• 推荐做法：统一在外层分组配置公共前缀，内层路由只写当前路由的name后缀即可，参考示例：

// 外层分组统一配置公共前缀，全局只配置一次
Route::prefix('crm')->name('crm.')->group(function () {
    Route::prefix('merchant')->name('merchant.')->group(function () {
        // 内层路由仅写最后一段name，不需要重复写前面的公共前缀
        Route::get('/merchant/klaim', [\App\Http\Controllers\Merchant\KlaimController::class, 'index'])
            ->name('klaim');
    });
});

按照上述写法，框架会自动拼接出预期的路由名crm.merchant.klaim，不会出现重复。

• 如果你不想调整外层分组配置，只需要把当前问题路由的name值里，和外层重复的前缀部分删掉即可，保证拼接后是目标名称。
• 修复完成后执行以下命令清理并重建路由缓存，不需要全量清理所有框架缓存：

php artisan route:clear
php artisan route:cache

注意：php artisan cache:clear是清理全局缓存的命令，路由缓存异常单独用route:clear即可，全量清缓存会额外清空会话、数据缓存等内容，非必要不执行。

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