Laravel 8路由前缀添加后失效，访问出现404错误求助

核心问题分析 #

你遇到的情况是本地环境下，在routes/admin.php中给路由组添加admin前缀后访问404，但去掉前缀后两个路径都能正常访问，服务器端却运行正常。核心原因大概率是路由前缀重复注册或者本地路由缓存/加载逻辑异常。

排查与解决步骤 #

1. 查看实际注册的路由
   执行以下命令，列出所有已注册的路由，明确前缀添加后的真实路径：

php artisan route:list

如果看到dashboard对应的路由是/admin/admin/new/dashboard，说明存在前缀重复的问题。

2. 检查web.php中admin路由的加载逻辑
   打开routes/web.php，查看加载admin.php的代码：

• 如果web.php中已经用prefix('admin')包裹了admin.php的加载，比如：

  Route::prefix('admin')->group(function () {
      require __DIR__.'/admin.php';
  });
  

  此时admin.php中再添加Route::prefix('admin')->group(...)就会导致前缀重复，最终路由变成/admin/admin/new/dashboard，自然访问/admin/new/dashboard会404。解决方法是去掉admin.php中的prefix('admin')。

• 如果web.php中既直接加载admin.php，又在prefix组里加载，就会导致路由重复注册，出现去掉前缀后两个路径都能访问的情况，需要删除其中一种加载方式。

3. 清理本地路由缓存
   开发环境下避免使用php artisan config:cache或php artisan route:cache，这类缓存会导致路由修改不及时生效。执行以下命令彻底清理缓存：

php artisan route:clear
php artisan config:clear
php artisan cache:clear

4. 检查路由冲突
   查看web.php中是否有通配符路由（比如Route::get('{any}', ...)）放在admin路由加载之前，这类路由会优先匹配请求，导致admin路由无法被命中。如果有，将admin路由的加载代码移到通配符路由之前。

5. 对比服务器与本地代码
   服务器端正常说明代码逻辑本身没问题，检查本地的web.php和admin.php是否与服务器端代码一致，可能是本地代码存在差异导致加载逻辑错误。

正确示例 #

方式一：web.php中添加前缀，admin.php中直接写路由

// routes/web.php
Route::prefix('admin')->group(function () {
    require __DIR__.'/admin.php';
});

// routes/admin.php
Route::get('/new/dashboard', [SuperAdminController::class,'dashboard']);
Route::get('/new/notifications', [SuperAdminController::class,'notifications']);

方式二：admin.php中添加前缀，web.php直接加载

// routes/web.php
require __DIR__.'/admin.php';

// routes/admin.php
Route::prefix('admin')->group(function(){
    Route::get('/new/dashboard',[SuperAdminController::class,'dashboard']);
    Route::get('/new/notifications', [SuperAdminController::class,'notifications']);
});

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