'use strict'; const { Service } = require('egg'); /** 每天额度按北京时间(UTC+8)切日,避免服务器时区不同导致「第二天」算错 */ const DAY_OFFSET_MS = 8 * 3600 * 1000; /** * 邮件发送日额度(每个邮箱每天最多 N 封) * * 注册验证码、找回密码重置链接**共用同一个额度**(同一个邮箱一天最多 `config.email.dailyLimit` 封,默认 10), * 超出直接拒绝,提示「明天再试」—— 防止被人拿一个邮箱刷爆发信配额 / 骚扰收件人。 * * 存 Redis: * - `packs:mailquota::` 当天已发次数(TTL 到当天 24 点 + 1 分钟) * * 用法: * ```js * const quota = await ctx.service.mailQuota.consume(email); // 先占额度 * if (!quota.ok) return { ok: false, message: quota.message }; * ... * await ctx.service.mailQuota.refund(email); // 没发出去就还回去 * ``` */ class MailQuotaService extends Service { get redis() { return this.app.redis; } get limit() { const value = Number((this.app.config.email || {}).dailyLimit); return Number.isFinite(value) && value > 0 ? value : 10; } /** 北京时间下的「今天」:yyyy-MM-dd */ today() { const shifted = new Date(Date.now() + DAY_OFFSET_MS); const pad = num => String(num).padStart(2, '0'); return `${shifted.getUTCFullYear()}-${pad(shifted.getUTCMonth() + 1)}-${pad(shifted.getUTCDate())}`; } /** 距离北京时间今天结束还有多少秒(+60 秒缓冲),用作 key 的 TTL */ secondsUntilTomorrow() { const shifted = new Date(Date.now() + DAY_OFFSET_MS); const midnight = Date.UTC( shifted.getUTCFullYear(), shifted.getUTCMonth(), shifted.getUTCDate() + 1, ); const remain = Math.ceil((midnight - shifted.getTime()) / 1000) + 60; return Math.max(remain, 60); } keyOf(email) { const normalized = String(email || '').trim().toLowerCase(); return `${this.app.config.cache.prefix}mailquota:${normalized}:${this.today()}`; } /** 只读:今天这个邮箱已经发了几封 */ async used(email) { if (!this.redis) return 0; try { const value = await this.redis.get(this.keyOf(email)); return Number(value) || 0; } catch (err) { this.ctx.logger.warn('[mailquota] 读取失败 %s : %s', email, err.message); return 0; } } /** * 占用一次额度 * @param {string} email 邮箱 * @return {Promise<{ok:boolean, used:number, limit:number, remaining:number, message?:string}>} */ async consume(email) { if (!this.redis) return { ok: true, used: 0, limit: this.limit, remaining: this.limit }; const normalized = String(email || '').trim().toLowerCase(); if (!normalized) return { ok: true, used: 0, limit: this.limit, remaining: this.limit }; const key = this.keyOf(normalized); try { const used = await this.redis.incr(key); if (used === 1) await this.redis.expire(key, this.secondsUntilTomorrow()); if (used > this.limit) { // 超额的这次不计入(回退),避免越堆越高 await this.redis.decr(key); this.ctx.logger.warn('[mailquota] %s 今日邮件已达上限 %s 封,拒绝发送', normalized, this.limit); return { ok: false, used: this.limit, limit: this.limit, remaining: 0, message: `该邮箱今天已发送 ${this.limit} 封邮件,达到上限,请明天再试`, }; } return { ok: true, used, limit: this.limit, remaining: Math.max(this.limit - used, 0), }; } catch (err) { // 计数失败不应挡住正常业务(Redis 抖动时优先保证能发信) this.ctx.logger.error('[mailquota] 计数失败 %s : %s', normalized, err.message); return { ok: true, used: 0, limit: this.limit, remaining: this.limit }; } } /** 还回一次额度(发信失败 / 被更短的重发节流拦下时调用) */ async refund(email) { if (!this.redis) return; const normalized = String(email || '').trim().toLowerCase(); if (!normalized) return; try { const key = this.keyOf(normalized); const left = await this.redis.decr(key); if (left < 0) await this.redis.del(key); } catch (err) { this.ctx.logger.warn('[mailquota] 回退失败 %s : %s', normalized, err.message); } } } module.exports = MailQuotaService;