import ResponseUtil from "../utils/responseUtil.js"; /** * 进程内速率限制(health 服务的写接口) * * 与 user 服务的限流同构,但有两点差异: * - 键优先用登录 token(已通过 requireAuth),避免多个用户共用同一 NAT 出口 IP 时互相挤占; * - 无 token 时回退到 IP,保证匿名请求也受限。 * * 说明:单进程内存计数,多实例部署时每个实例各自计数(当前为单机部署, * 若后续横向扩容需换成 Redis 之类的共享计数)。 */ const cleanupInterval = 60_000; // 所有计数桶统一登记,由一个定时器清理,避免为每个 limiter 各起一个 timer const stores = new Set(); function registerStore(buckets) { stores.add(buckets); return buckets; } /** * 清理所有过期计数(社区版只做内存回收,不影响限流语义: * 访问时本身也会按窗口重置) * @param {number} [now] 当前时间(测试可注入) * @returns {number} 清理的条目数 */ function sweepRateLimitStores(now = Date.now()) { let removed = 0; for (const buckets of stores) { for (const [key, record] of buckets) { if (now - record.resetAt > record.windowMs) { buckets.delete(key); removed += 1; } } } return removed; } const cleanupTimer = setInterval(() => sweepRateLimitStores(), cleanupInterval); cleanupTimer.unref(); // 路径里可能带订单 ID;路由没匹配到模式时(理论上不该发生)兜底归一 const OBJECT_ID_SEGMENT = /\/[0-9a-fA-F]{24}(?=\/|$)/g; function normalizeDynamicPath(path) { return String(path || "").replace(OBJECT_ID_SEGMENT, "/:id"); } /** * 限流分桶键 * * 用路由模式(如 /health/escort-record/:id)而不是真实 path: * 否则同一用户在不同订单上各有一份额度,换个 ID 就能绕过限流。 */ function resolveBucketPath(ctx) { return ctx.routerPath || ctx._matchedRoute || normalizeDynamicPath(ctx.path); } const store = registerStore(new Map()); /** * 创建限流中间件 * @param {number} max 窗口内最大请求数 * @param {number} windowMs 窗口时长(毫秒) */ function rateLimit(max, windowMs = 60_000) { return async (ctx, next) => { const identity = ctx.state.user?._id ? `u:${ctx.state.user._id}` : `ip:${ctx.ip}`; const key = `${identity}:${ctx.method}:${resolveBucketPath(ctx)}`; const now = Date.now(); let record = store.get(key); if (!record || now - record.resetAt > windowMs) { record = { count: 0, resetAt: now, windowMs }; store.set(key, record); } record.count++; if (record.count > max) { const retryAfter = Math.ceil((record.resetAt + windowMs - now) / 1000); ctx.set("Retry-After", String(retryAfter)); return ResponseUtil.error(ctx, "操作过于频繁,请稍后再试", null, 429); } ctx.set("X-RateLimit-Limit", String(max)); ctx.set("X-RateLimit-Remaining", String(Math.max(0, max - record.count))); await next(); }; } /** * 按用户维度的限流(供 WebSocket 等无 ctx 的场景复用) * @param {string} identity 身份键(通常是 userId) * @param {number} max 窗口内最大次数 * @param {number} windowMs 窗口时长(毫秒) * @returns {(identity: string) => {allowed: boolean, retryAfter: number}} */ function createUserLimiter(max, windowMs = 60_000) { // windowMs 写进记录,供统一清理逻辑判断过期 const buckets = registerStore(new Map()); return (identity) => { const now = Date.now(); let record = buckets.get(identity); if (!record || now - record.resetAt > windowMs) { record = { count: 0, resetAt: now, windowMs }; buckets.set(identity, record); } record.count++; if (record.count > max) { return { allowed: false, retryAfter: Math.ceil((record.resetAt + windowMs - now) / 1000), }; } return { allowed: true, retryAfter: 0 }; }; } export { rateLimit, createUserLimiter, sweepRateLimitStores, normalizeDynamicPath };