LaravelAPI请求率限制怎么设置_LaravelAPI请求率限制的设置方法【方法】-Laravel-PHP中文网

RateLimiter 未生效主因是 throttle 中间件注册顺序错误，须置于 auth:api 后、bindings 前且仅在 $middlewareGroups['api'] 中；需自定义限流器按用户 ID 限流，并避免 Redis 故障导致 API 瘫痪。

laravelapi请求率限制怎么设置_laravelapi请求率限制的设置方法【方法】

API 请求限流不生效，90% 是因为 throttle 中间件被放在了 auth 或 api 之外——它必须在认证之后、路由匹配之前运行，否则匿名请求会直接被拦在门外，而登录用户又可能绕过规则。

app/Http/Kernel.php 中，确保 throttle:api 在 auth:api 之后、bindings 之前
不要把它加到全局 $middleware，只放 $middlewareGroups['api'] 里
如果用了自定义 guard（比如 sanctum），确认 throttle 的 key 生成逻辑能拿到用户 ID；否则默认按 IP 限流，对登录用户无效

Laravel 默认的 throttle:60,1,public 按 IP 限流，但 API 场景下更需要“每个用户每分钟最多 60 次”。这得靠自定义限流器，而不是改中间件参数。

在 App\Providers\RouteServiceProvider::boot() 里注册：

RateLimiter::for('api_by_user', function (Request $request) {
    return Limit::perMinute(60)->by($request->user()?->id ?? $request->ip());
});

路由中使用：->middleware('throttle:api_by_user')
注意：若用户未登录，$request->user() 返回 null，?? $request->ip() 是兜底，避免 key 变成 null 导致全站共享一个桶

像 throttle:60,1,public 这种写法里的 public，是指是否允许客户端缓存响应头（X-RateLimit-*），和“是否公开限流策略”完全无关。设成 public 可能让 CDN 或浏览器缓存限流头，导致后续请求误判。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

限流器底层依赖 Redis，默认配置下一旦 Redis 不可用，throttle 会抛出 ConnectionException，导致所有 API 请求 500。这不是预期行为。

在 config/cache.php 中为 redis 驱动设置 'retry_after' => 0 和 'connect_timeout' => 1，缩短失败等待时间
更稳妥的是换用 cache 驱动（如 array 或 file）做临时降级，但要注意：这些驱动不支持分布式，多实例部署时失效
生产环境强烈建议用 Redis Sentinel 或 Cluster，并在 APP_ENV=production 下禁用 array 缓存驱动——它不会报错，但会让限流形同虚设