Laravel/Lumen中/admin/*路由指向视图遇404问题排查

看起来你遇到的问题是Laravel没有正确匹配到你的兜底/admin路由，导致返回框架自带的404，而不是交给Vue处理。我来帮你排查几个常见的原因：

1. 路由顺序问题 #

Laravel的路由是按定义顺序匹配的，如果你的Route::prefix('admin')->group(...)兜底路由放在了其他/admin相关路由的前面，那具体的路由会先匹配，兜底路由永远不会触发。

比如，正确的顺序应该是这样：

Route::prefix('admin')->group(function () {
    // 所有具体的admin路由放在前面
    Route::get('dashboard', [AdminController::class, 'dashboard']);
    // 兜底路由要放在最后
    Route::any('{query}', function() { return view('admin'); })->where('query', '.*');
});

确保兜底路由是admin组里的最后一条，这样所有没匹配到具体路由的/admin请求才会走到它。

2. Apache的.htaccess配置问题 #

这是最容易忽略的点！如果你的Apache没有正确配置，会直接尝试访问物理路径（比如不存在的/admin文件夹），返回Apache的404，而不是把请求交给Laravel处理。

检查项目根目录下的.htaccess文件，确保有以下核心规则：

<IfModule mod_rewrite.c>
    RewriteEngine On

    # 把所有非文件/非目录的请求转发到index.php
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

另外，还要检查Apache虚拟主机配置里的AllowOverride All是否开启（否则.htaccess不会生效）：

<Directory /path/to/your/project/public>
    AllowOverride All
    Require all granted
</Directory>

修改后记得重启Apache服务。

3. 路由缓存问题 #

如果你之前执行过php artisan route:cache生成了路由缓存，新添加的路由不会被加载。执行以下命令清除缓存：

php artisan route:clear
php artisan config:clear

之后再访问/admin路径试试。

4. 检查视图文件是否存在 #

确保你的admin视图文件存在于resources/views/admin.blade.php，如果视图不存在，Laravel会返回404（虽然你说日志没报错，但还是确认一下）。

5. 开启调试模式排查 #

把.env文件里的APP_DEBUG设为true，这样如果有隐藏的错误，Laravel会显示详细的错误信息，而不是直接返回404，这能帮你快速定位问题。

6. 中间件冲突排查 #

检查是否有全局中间件或者admin路由组的中间件拦截了请求。比如某些权限验证中间件，如果没有通过会直接返回404（如果日志没记录，可能是中间件没写日志）。你可以暂时移除admin路由组的中间件，测试是否能正常返回视图。

我之前也遇到过类似的问题，当时就是Apache的AllowOverride没开，导致请求根本没到Laravel。按照上面的步骤逐一排查，应该能解决你的问题。

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