Laravel 中实现接口限流最简单的方式是使用内置 throttle 中间件，支持按 IP、用户 ID 或自定义维度限流，需配置 Redis 缓存并统一处理 429 响应。
在 Laravel 中实现接口限流最简单的方式是使用框架自带的 速率限制中间件，无需额外安装包，几行配置就能生效。
直接用内置 throttle 中间件
Laravel 从 5.2 起就内置了 throttle 中间件，它基于 Redis（推荐）或文件缓存做请求计数。只要路由加个中间件，指定“每分钟最多多少次”即可：
- 在路由定义中添加：
->middleware('throttle:60,1')表示每分钟最多 60 次请求 - 支持更细粒度，比如
throttle:10,60表示每 60 秒最多 10 次 - 对登录接口常用 IP + 用户 ID 双维度限流：
throttle:5,1,by=ip|id（需自定义逻辑或升级到 Laravel 10+ 的throttle:5,1,by=ip+ 用户标识判断）
按用户身份区分限流阈值
默认 throttle 是按 IP 限流，但 API 接口常需“登录用户限频更高、游客更严格”。可在 app/Http/Kernel.php 的 $middlewareGroups 中扩展中间件别名：
- 新增一个中间件别名，如
'auth.throttle' => [EnsureUserIsAuthenticated::class, 'throttle:120,1'] - 或在控制器构造函数里动态绑定：
$this->middleware('throttle:30,1')->only(['store']); - 进阶做法：重写
ThrottleRequests中间件，在resolveRequestSignature()方法里返回包含用户 ID 的唯一签名（如auth()->id() ?: $request->ip()）
返回友好提示和响应头
触发限流时，默认返回 429 状态码和 JSON 提示。你可以统一处理响应格式：
- 在
app/Exceptions/Handler.php的render()方法中捕获ThrottleRequestsException - 返回结构化 JSON，例如：
['message' => '请求过于频繁，请稍后再试', 'retry_after' => $exception->getHeaders()['Retry-After']] - 前端可通过响应头
X-RateLimit-Limit和X-RateLimit-Remaining显示倒计时或禁用按钮
注意缓存驱动和部署一致性
限流依赖缓存计数，务必确认生产环境使用的是 Redis 或 Memcached：
- 检查
CACHE_DRIVER和REDIS_CLIENT配置是否正确 - 多台服务器部署时，不能用 file 缓存，否则限流失效
- 开发时若用 array 驱动，限流只在单请求内生效，上线前必须切换
不复杂但容易忽略：限流规则对高频接口要单独测试，尤其关注并发场景下 Redis 原子操作是否准确。
