Laravel：如何为部分路由绕过Throttle中间件？自定义中间件无效

核心思路 #

要跳过中间件内的查询逻辑，核心是控制中间件执行范围或提前标记跳过规则，以下是几种可行的落地方案：

方案一：用Laravel自带的withoutMiddleware（最简单直接） #

如果执行查询的中间件是路由中间件/组中间件（而非全局中间件），直接在路由定义时排除：

1. 先定位到执行查询的中间件类，比如QueryMiddlewareA和QueryMiddlewareB
2. 在需要跳过的路由上添加排除规则：

// 单个路由
Route::get('/public/data', [PublicController::class, 'getData'])->withoutMiddleware([
    \App\Http\Middleware\QueryMiddlewareA::class,
    \App\Http\Middleware\QueryMiddlewareB::class
]);

// 批量路由组
Route::prefix('open')->withoutMiddleware([
    \App\Http\Middleware\QueryMiddlewareA::class,
    \App\Http\Middleware\QueryMiddlewareB::class
])->group(function () {
    Route::get('/status', [OpenController::class, 'getStatus']);
    Route::post('/notify', [OpenController::class, 'sendNotify']);
});

注意：withoutMiddleware无法跳过全局中间件（Kernel.php中$middleware数组内的），如果你的查询逻辑在全局中间件里，先把它们移到$middlewareGroups的web或api组中。

方案二：自定义标记中间件（适配复杂场景） #

如果必须保留全局中间件，或者需要更灵活的跳过逻辑，可采用标记法：

1. 创建标记中间件WithoutQueries：

// app/Http/Middleware/WithoutQueries.php
<?php

namespace App\Http\Middleware;

use Closure;

class WithoutQueries
{
    public function handle($request, Closure $next)
    {
        // 给请求添加跳过标记
        $request->attributes->set('skip_queries', true);
        return $next($request);
    }
}

2. 在Kernel.php中注册该中间件，并确保它在查询中间件之前执行（顺序错误会直接失效）：

// app/Http/Kernel.php
protected $routeMiddleware = [
    // ...其他中间件
    'without.queries' => \App\Http\Middleware\WithoutQueries::class,
];

// 如果是全局中间件，把它放到$middleware数组的最前面
protected $middleware = [
    \App\Http\Middleware\WithoutQueries::class,
    // ...其他全局中间件（包含你的查询中间件）
];

3. 修改查询中间件，判断标记后再执行逻辑：

// 示例查询中间件
public function handle($request, Closure $next)
{
    // 只有不存在跳过标记时，才执行查询
    if (!$request->attributes->get('skip_queries', false)) {
        // 你的查询逻辑
        \DB::table('target_table')->where(...)->get();
    }
    return $next($request);
}

4. 在需要跳过的路由上应用该标记中间件：

Route::get('/skip/query', [TestController::class, 'test'])->middleware('without.queries');

排查之前withoutThrottle失效的常见原因 #

1. 中间件顺序错误：你的withoutThrottle可能在查询中间件之后执行，导致查询已经跑完才触发跳过标记，调整顺序到查询中间件之前即可。
2. 全局中间件无法被排除：如果查询逻辑在全局中间件里，withoutMiddleware不生效，必须用方案二的标记法。
3. 路由归属错误：需要跳过的路由被包含在强制应用查询中间件的路由组内，需检查路由结构调整分组。

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