Laravel 8 POST方法路由速率限制不生效问题如何解决

云原生阿岚

2026-10-6

Laravel 8 POST路由速率限制不生效解决方案

核心原因1：路由未绑定速率限制中间件

你已定义名为api的速率限制器，但当前POST路由仅挂载了key中间件，未关联速率限制规则，所以不会触发限流。

修复方案二选一：

单路由绑定：直接给当前POST路由追加throttle中间件，修改路由代码：

Route::post('/temporalrisk/v1', [TemporalRouteRiskV1::class, 'postMethod'])
    ->middleware(['key', 'throttle:api'])
    ->name('temporalrouteriskv1.index');

全局API路由绑定：确认app/Http/Kernel.php中api中间件组已默认包含throttle:api，将所有API路由放到api中间件组下统一生效：

Route::middleware('api')->group(function () {
    Route::post('/temporalrisk/v1', [TemporalRouteRiskV1::class, 'postMethod'])
        ->middleware('key')
        ->name('temporalrouteriskv1.index');
    // 其他API路由统一放在此处
});

核心原因2：API Key维度的限制规则失效

你第二组规则用$request->input('key')作为限流维度，出现以下情况时规则会自动跳过：

POST请求未携带key参数，导致by()方法参数为空
你的key中间件会修改/清除请求参数中的key字段，速率限制器拿不到对应值

修复方案：

增加空值判断兜底，避免规则失效，修改速率限制器代码：

RateLimiter::for('api', function (Request $request) {
    $limits = [
        // IP维度限流固定生效
        Limit::perMinute(env('IP_ADDR_RATE_LIMITER_PER_MINUTE', 60))->by($request->ip())->response(function () {
            // 自定义超限响应逻辑
        }),
    ];
    // 仅存在有效key参数时追加API Key维度限流
    if ($request->has('key')) {
        $limits[] = Limit::perMinute(env('API_KEY_RATE_LIMITER_PER_MINUTE', 60))->by($request->input('key'))->response(function () {
            // 自定义超限响应逻辑
        });
    }
    return $limits;
});