直接用Flask-Limiter的IP限流够用，因其原生支持按客户端IP限流且可配置key_func提取真实IP（如解析X-Forwarded-For），但需避免直接依赖request.remote_addr导致代理环境下误判为127.0.0.1。
为什么直接用 flask-limiter 的 ipaddr key 就够用？
Flask 默认不带限流能力，但 flask-limiter 是最轻量、最贴近需求的方案——它原生支持按客户端 IP 提取和限流，且底层自动处理了代理穿透（如 Nginx 转发后的真实 IP）。关键不是“能不能做”，而是“怎么避免误判”。
常见错误是直接读 request.remote_addr，在反向代理环境下它永远是 127.0.0.1 或代理内网地址。必须配合 trusted_proxies 配置或手动解析 X-Forwarded-For。
- 若部署在 Nginx 后，确保 Nginx 已配置
proxy_set_header X-Forwarded-For $remote_addr; - 初始化
Limiter时传入key_func显式提取真实 IP：from flask_limiter import Limiter from flask_limiter.util import get_remote_address limiter = Limiter( app, key_func=lambda: request.headers.get("X-Forwarded-For", request.remote_addr).split(",")[0].strip() ) - 不推荐依赖
get_remote_address默认行为，它不解析X-Forwarded-For多级代理链
@limiter.limit 中的速率字符串怎么写才不踩坑？
速率格式是 "<number> per <time_unit>"</time_unit></number>，但单位拼写、空格、复数都敏感。错一个字符就变成无限制或立即触发 429。
- 正确写法：
"100 per day"、"5 per minute"、"1 per second" - 错误写法：
"100/day"（不识别斜杠）、"5 minutes"（必须用单数minute）、"5 per 1 minute"（数字不能带单位前缀） - 时间单位只支持
second、minute、hour、day、month、year，没有sec或hr - 多个限流策略可叠加，比如同时加
"10 per minute"和"100 per day"，任一超限即拒绝
如何让限流只作用于特定 API 路由，而不影响静态文件或健康检查？
默认全局生效会误杀 /static/、/health 这类路径。必须显式排除或精确绑定。
立即学习“Python免费学习笔记（深入）”；
- 用
exempt_when参数跳过某些请求：limiter.exempt_when = lambda: request.endpoint in ["health.check", "static"]
- 更稳妥的是只装饰目标视图函数，而不是用
@limiter.limit装饰器套整个蓝图：@app.route("/api/data") @limiter.limit("10 per minute") def api_data(): return {"result": "ok"} - 注意：如果用了蓝图，
request.endpoint是blueprint_name.view_function_name，不是路由路径
Redis 作为后端时，连接失败会导致 API 直接 500 吗？
不会，默认策略是“fail open”：当 Redis 不可用时，flask-limiter 自动退化为无限制模式，API 继续响应。这符合线上容灾逻辑，但容易让人误以为限流没生效。
- 可通过
on_error回调记录日志确认降级：def on_limiter_error(request): app.logger.warning("Rate limit backend unavailable, falling back to unlimited") limiter = Limiter(..., on_error=on_limiter_error) - 若需 fail closed（Redis 挂了就全部拒绝），得自己重写
storage类并抛异常，但生产环境极少这么做 - 本地开发用
memory后端没问题，但上线必须切 Redis 或 Memcached，否则多进程下计数不共享
request.headers.get("X-Forwarded-For")，也别靠猜。 
