Nginx可通过map提取用户ID（如从Header或Cookie）并结合limit_req_zone实现基于用户ID的限流；需注意空值归桶、内存限制及静态速率等关键约束。
Nginx 的 limit_req_zone 本身不直接支持按用户 ID（如从 JWT、Cookie 或 Header 中提取）做限流，但可以通过 自定义变量 + map 指令 + limit_req_zone 的组合方式，实现基于用户 ID 的精细化限流。
提取用户 ID 到自定义变量
用户 ID 通常存在于请求头（如 X-User-ID）、Cookie（如 uid=12345）或 JWT payload 中。Nginx 原生不解析 JWT，所以推荐优先使用可信上游（如网关）提前解密并透传 ID 到 Header；若必须在 Nginx 层提取，可借助 map 从 Cookie 或 Header 中正则捕获：
- 从 Header 提取：
map $http_x_user_id $user_id {
default "";
~^(?\d+)$ $uid;
} - 从 Cookie 提取（需先启用
http_cookie模块支持正则）：
map $http_cookie $user_id {
default "";
~uid=(\d+) $1;
}
注意：变量值为空（""）时，limit_req_zone 会统一归入同一桶（即所有未认证用户共用一个计数器），建议搭配 limit_req 的 burst 和 nodelay 谨慎控制。
定义基于用户 ID 的限流区域
使用上一步的 $user_id 变量创建限流 zone，内存大小按预期并发用户量估算（每个 key 约占用 64 字节）：
- limit_req_zone $user_id zone=user_limit:10m rate=5r/s;（每个用户每秒最多 5 次请求）
- 若需区分免费/付费用户，可先用
map映射等级：
map $user_id $user_tier {
default "free";
~^100[0-9]{3}$ "premium";
}
limit_req_zone $user_tier zone=tier_limit:10m rate=20r/s;
在 location 中启用限流并处理拒绝逻辑
在 server 或 location 块中调用 limit_req，推荐开启 burst 缓冲突发流量，并用 nodelay 避免排队延迟（适用于对响应时间敏感的接口）：
- location /api/v1/profile {
limit_req zone=user_limit burst=10 nodelay;
proxy_pass http://backend;
} - 返回友好提示：通过
error_page 503自定义响应体，或配合 OpenResty 使用 Lua 注入 JSON 错误信息 - 记录被限流请求：添加
log_format记录$user_id和$limit（Nginx 1.13.10+ 支持）便于排查
关键注意事项
-
空值陷阱：$user_id 为空时所有匿名请求共享同一个限流桶，务必在业务层确保登录态透传，或用
map设默认唯一标识（如 IP + UA 哈希）兜底 - 共享内存限制：zone 内存固定，用户量过大（如千万级）可能导致 key 驱逐，此时应考虑分片（如按 user_id % 4 分 4 个 zone）或改用 Redis 限流
- 不支持动态速率：rate 是静态配置，如需按用户等级动态调整，需配合多个 zone + 多层 map 判断，或交由外部服务（如 Auth Service）返回速率策略
-
与 proxy_cache 冲突：限流发生在 access 阶段，早于 cache，不影响缓存逻辑；但若用
limit_req+proxy_cache，需确认是否对缓存命中也计数（默认是）
