Laravel路由组中间件顺序与同路径路由按订阅状态匹配问题

核心路由匹配规则 #

Laravel的路由处理遵循两个核心逻辑：

• 路由匹配阶段是从上到下逐行扫描，只要找到第一个和当前请求方法、URI完全匹配的路由，就会终止匹配流程，不会继续校验后续的同名路由，和路由组绑定的中间件无关。
• 中间件是在路由匹配完成后才会按顺序执行的，中间件校验失败只会返回当前路由定义的错误响应，不会触发路由重新匹配。

问题解答 #

1. 两个路由组的基础处理逻辑 #

你定义的两个路由组，同名路由的执行逻辑完全由定义顺序决定：

• 如果你把无subscriptions中间件的路由组放在前面：所有请求都会先匹配到该组的路由，直接执行对应逻辑，永远不会触发带订阅校验的同名路由。
• 如果你把带subscriptions中间件的路由组放在前面：所有请求先匹配到该组路由，执行中间件校验，校验通过执行对应逻辑，校验失败直接返回中间件定义的响应（你当前的跳转首页），不会回退匹配前一组的同名路由。

2. 其他疑问解答 #

• 满足第一组中间件要求的用户，不会自动校验第二组的中间件：只要匹配到第一组路由，就不会进入第二组的路由范围。
• 已完成邮箱验证的用户可以进入第二组路由的前提是：第二组路由放在更靠前的位置，用户请求先匹配到第二组的路由，且subscriptions中间件校验通过。
• 路由组的编写顺序直接决定了能否匹配到预期路由，对处理逻辑影响极大。

预期效果实现方案 #

你想要的「有订阅返回视图、无订阅跳转支付」的效果，推荐以下两种实现方式：

方案1：合并路由逻辑（最简方案） #

不需要定义两个同名路由，直接在同一个路由内做订阅判断即可：

Route::group(['middleware' => ["auth:sanctum", "verified"]], function () {
    Route::get("/new", function () {
        // 替换为你实际的订阅有效判断方法
        if (auth()->user()->hasValidSubscription()) {
            return view("bourse-new");
        }
        // 无订阅跳支付页
        return redirect()->route('new-payment');
    })->name("new");
});

方案2：保留双路由+修改异常处理逻辑 #

如果你一定要保留两个同名路由的结构，按以下步骤修改：

1. 调整路由顺序，把带subscriptions中间件的路由组放在前面：

// 带订阅校验的路由组放前面
Route::group(['middleware' => ["auth:sanctum", "verified", "subscriptions"]], function () {
    Route::get("/new", function () {
        return view("bourse-new");
    })->name("new-abo");
});

// 无订阅校验的路由组放后面
Route::group(['middleware' => ["auth:sanctum", "verified", ]], function () {
    Route::get("/new", function () {
        // redirect to payment
    })->name("new-payment");
});

2. 修改app/Exceptions/Handler.php，捕获订阅校验失败的异常，跳转至支付路由：

use Laravel\Cashier\Exceptions\IncompleteSubscription;

public function register()
{
    $this->renderable(function (IncompleteSubscription $e, $request) {
        // 匹配/new路径时跳转到支付路由，其他路径保留默认跳转逻辑
        if ($request->path() === 'new') {
            return redirect()->route('new-payment');
        }
        return redirect()->route('home');
    });
}

如果你用的是自定义的subscriptions中间件，直接把中间件里校验失败后的跳转逻辑改成return redirect()->route('new-payment')即可。

内容的提问来源于stack exchange，提问作者Fouvet Sébastien