Laravel 8全局限流配置失效及请求数异常问题求助

一、解决configureRateLimiting()未触发问题 #

• 检查RouteServiceProvider.php的boot()方法，确保已调用$this->configureRateLimiting();。Laravel 8默认的RouteServiceProvider中，boot方法会自动调用该配置方法，若为手动添加的方法，需确认未遗漏调用步骤。示例代码：

public function boot()
{
    $this->configureRateLimiting();

    parent::boot();
}

• 清除路由缓存：执行php artisan route:clear，避免缓存的路由配置导致新限流规则不生效。
• 确认configureRateLimiting()中的日志代码是否正确，比如使用\Log::info('Rate limiting configured');，同时检查config/logging.php确保日志通道配置正常。

二、解决限流次数为设置值一半的问题 #

该问题通常由限流中间件重复执行导致，常见原因及修复方案：

• 检查Kernel.php的web中间件组，若已包含ThrottleRequests，同时控制器构造函数中又添加了throttle:global，会造成同一次请求被计数两次。解决方式：保留其中一种即可——要么通过中间件组应用configureRateLimiting()中的全局限流规则，要么在控制器/路由中单独指定限流规则，不要重复叠加。
• 排查路由重复注册情况：执行php artisan route:list查看路由列表，确认是否存在同一路由在多个文件中重复注册的情况，避免请求被两次命中限流逻辑。
• 排除OPTIONS预请求计数：部分前端框架会发送OPTIONS请求做跨域预检，若自定义中间件导致该请求被计数，可在configureRateLimiting()中排除：

RateLimiter::for('global', function (Request $request) {
    if ($request->isMethod('OPTIONS')) {
        return Limit::none();
    }
    return Limit::perMinute(20)->by($request->ip());
});

• 检查缓存驱动：临时将config/cache.php中的default缓存驱动改为array测试，若计数恢复正常，说明原缓存驱动存在配置或权限问题，需对应修复。

三、验证修复效果 #

• 执行php artisan optimize:clear清除所有缓存，确保配置生效。
• 使用Postman或curl多次请求接口，观察触发429的次数是否符合设置值，同时查看日志确认configureRateLimiting()是否被触发。

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