用slowapi最省事,它专为FastAPI设计,支持内存或Redis后端,提供路由级、用户级、IP级限流,不侵入业务逻辑,且避免手写限流的并发与时间窗口问题。

FastAPI 限流用什么库最省事?
直接上结论:用 slowapi,它专为 FastAPI 设计,基于 Starlette 的中间件机制,不侵入业务逻辑,支持路由级、用户级、IP 级限流,且默认用内存存储(适合单实例),也支持 Redis 后端。
常见错误是自己手写依赖或中间件去计数,结果漏掉并发场景下的竞态问题,或者没处理好时间窗口滑动(比如用固定窗口导致突刺流量打穿)。slowapi 底层用 aioredis 或 redis-py(异步/同步)做原子 incr + expire,避免了这类坑。
使用时注意三点:
- 安装:
pip install slowapi - 必须注册
Limiter实例为 FastAPI 的依赖(通常在app = FastAPI()后立即初始化) - 路由装饰器
@limiter.limit("5/minute")中的速率字符串必须符合count/rate格式,rate只支持second、minute、hour、day
from fastapi import FastAPI, Depends
from slowapi import Limiter, _rate_limit_exceeded_handler
from slowapi.util import get_remote_address
from slowapi.errors import RateLimitExceeded
<p>app = FastAPI()
limiter = Limiter(key_func=get_remote_address)
app.state.limiter = limiter
app.add_exception_handler(RateLimitExceeded, _rate_limit_exceeded_handler)</p><p>@app.get("/public")
@limiter.limit("10/minute")
async def public_endpoint():
return {"msg": "OK"}</p>熔断器该不该在 FastAPI 层实现?
不该。FastAPI 是 HTTP 框架,不是服务治理层;熔断本质是客户端对下游依赖的容错策略,应放在调用方(比如你的 FastAPI 服务去调第三方 API 时),而不是在入口路由上做“请求熔断”。
立即学习“Python免费学习笔记(深入)”;
典型误用:有人试图用中间件拦截所有请求,统计失败率再开关路由——这既混淆了“限流”和“熔断”,又把状态耦合进 Web 层,导致无法区分是下游超时、连接拒绝,还是业务逻辑异常。
真正该用的库是 tenacity 或 circuitbreaker,它们专注重试与状态机管理。例如用 tenacity 对某个 HTTP 调用加熔断:
Python 环境工具专业版功能概述Python 环境工具专业版是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。执行完成后建议检查结果是否符合预期,并保留必要记录。使用与执行同时注意输入完整性、执行条件和输出可用性。从功能定位来看,该技能
- 失败连续 3 次 → 进入半开状态
- 半开时只放行 1 个请求试探
- 成功则恢复,失败则重置计时器
from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_exception_type
import httpx
<p>@retry(
stop=stop_after_attempt(3),
wait=wait_exponential(multiplier=1, min=1, max=10),
retry=retry_if_exception_type((httpx.TimeoutException, httpx.HTTPStatusError))
)
async def call_downstream():
async with httpx.AsyncClient() as client:
resp = await client.get("<a href="https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca">https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca</a>")
resp.raise_for_status()
return resp.json()</p>Redis 限流 + 熔断状态共享怎么配?
关键点:限流和熔断的状态存储不能混用。限流需要高吞吐、低延迟的计数(Redis 的 INCR + EXPIRE 最合适);熔断状态则是少量键值(如 circuit:service-x),但要求强一致性与 TTL 自动清理。
slowapi 支持 Redis 后端,只需传入 RedisStorage 实例:
from slowapi.storage.redis import RedisStorage
import redis
<p>redis_client = redis.from_url("redis://localhost:6379")
storage = RedisStorage(redis_client)
limiter = Limiter(key_func=get_remote_address, storage=storage)</p>而熔断器状态若也想存 Redis(比如多实例部署需共享熔断状态),得自己封装。不要复用同一个 Redis 连接池做两件事——限流高频小命令,熔断低频大状态变更,容易互相干扰。建议:
- 限流用专用 Redis DB(如 DB 0)
- 熔断状态用另一个 DB(如 DB 1)或独立 Redis 实例
- 熔断键名加上服务标识前缀,比如
circuit:payment-service,避免跨服务污染
为什么 /docs 页面常被限流误伤?
因为 slowapi 默认对所有路由生效,包括 Swagger UI 的静态资源(/docs、/openapi.json)。前端反复刷新文档页会快速触发 IP 级限流,导致开发时连接口都打不开。
解决办法很简单:给文档路由显式豁免。
@app.get("/docs", include_in_schema=False)
@limiter.exempt
async def custom_docs():
return get_swagger_ui_html(openapi_url="/openapi.json", title="docs")
<p>@app.get("/openapi.json", include_in_schema=False)
@limiter.exempt
async def get_openapi():
return JSONResponse(app.openapi())</p>更稳妥的做法是在初始化 Limiter 时用自定义 key_func 排除特定路径,但直接 @limiter.exempt 更直观、不易漏。
实际部署时最容易忽略的是:限流规则没随环境变化。开发时宽松(100/minute),上线却忘了改成 10/second;或者熔断超时设置成 30 秒,但下游服务平均响应才 200ms——等于永远熔不断。这些数值必须基于真实压测和监控反馈来调,不能凭感觉填。

















