后端 - 新增 service/mail_quota.js:每个邮箱每天最多 config.email.dailyLimit(默认 10,EMAIL_DAILY_LIMIT)封, 注册验证码与找回密码**共用**额度;按北京时间切日,key TTL 到次日 0 点; 发信失败 / 被 60 秒节流拦下会还回额度;超限返回 429 daily_limit「… 请明天再试」 - service.user.findByEmail() / emailExists():LOWER(email) 查询(大小写不敏感)+ paranoid:false (软删除账号仍占用邮箱),单测环境无 sequelize 时退化为等值查询 - register/code:先判邮箱已占用 → 409 email_taken(含「忘记密码可找回」提示),一封邮件都不发; 发送失败/超限统一返回 429 + status(daily_limit / send_failed) - register:提交时再判一次邮箱占用(防发码后被抢注) - forgot:改用 findByEmail(大小写/软删除一致),日额度与注册共用,超限 429 - 单测:新增「邮箱已使用不发信」「每日 10 封上限(注册/找回)」4 个用例;fake-redis 补 decr 前端 - 登录页获取验证码:先做邮箱格式校验,并展示后端 409/429 的具体文案 - 忘记密码页:邮箱格式校验 + 小写归一,429 文案直接显示 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
148 lines
5.7 KiB
JavaScript
148 lines
5.7 KiB
JavaScript
'use strict';
|
||
|
||
const { Service } = require('egg');
|
||
const crypto = require('crypto');
|
||
|
||
/** 重置令牌在 Redis 里的 key 段(与验证码分开,互不影响) */
|
||
const SEGMENT = 'reset';
|
||
|
||
/** 令牌原文 → 摘要(Redis 里只存摘要,泄库也拿不到可用的重置链接) */
|
||
function digest(token) {
|
||
return crypto.createHash('sha256').update(String(token)).digest('hex');
|
||
}
|
||
|
||
/**
|
||
* 邮箱找回密码:生成 / 校验 / 消费「重置密码链接」里的令牌
|
||
*
|
||
* 存 Redis(都带 TTL,过期自动失效):
|
||
* - `packs:reset:token:<摘要>` 令牌 → 用户 id(TTL = config.email.resetTtl,默认 30 分钟)
|
||
* - `packs:reset:user:<用户id>` 该用户**当前**最后一次发出的令牌摘要(用于让旧链接立刻失效)
|
||
* - `packs:reset:sent:<用户id>` 重发节流标记(SET NX,TTL = config.email.resendInterval,默认 60 秒)
|
||
* - `packs:mailquota:<email>:<date>` 当日发信次数(`service/mail_quota.js`,与注册验证码**共用**每天 10 封的额度)
|
||
*
|
||
* 令牌是一次性的:重置成功后 `consume()` 把上面两个 key 都删掉。
|
||
* 对外不抛异常,统一返回 `{ ok, message }`,方便页面回提示(不弹 500)。
|
||
*/
|
||
class PasswordResetService extends Service {
|
||
get redis() {
|
||
return this.app.redis;
|
||
}
|
||
|
||
get cfg() {
|
||
return this.app.config.email;
|
||
}
|
||
|
||
prefix(rest) {
|
||
return `${this.app.config.cache.prefix}${SEGMENT}:${rest}`;
|
||
}
|
||
|
||
tokenKey(token) {
|
||
return this.prefix(`token:${digest(token)}`);
|
||
}
|
||
|
||
userKey(userId) {
|
||
return this.prefix(`user:${userId}`);
|
||
}
|
||
|
||
sentKey(userId) {
|
||
return this.prefix(`sent:${userId}`);
|
||
}
|
||
|
||
/** Redis 不可用时给友好提示,而不是让页面 500 */
|
||
unavailable() {
|
||
return { ok: false, reason: 'unavailable', message: '重置密码服务暂不可用(Redis 未就绪),请稍后再试' };
|
||
}
|
||
|
||
/**
|
||
* 生成重置链接并发送邮件(同一个用户只保留最新一条链接,旧链接立即失效)
|
||
*
|
||
* 发信前先占「每日额度」(同一邮箱每天最多 `config.email.dailyLimit` 封,默认 10,
|
||
* 与注册验证码共用),再受 `resendInterval` 重发节流约束;两种拦截都不会真的发信。
|
||
*
|
||
* @param {object} user 用户实例(需要 id / email)
|
||
* @param {string} origin 站点地址(如 http://127.0.0.1:7300)
|
||
* @return {Promise<{ok:boolean, message?:string, reason?:string, devMode?:boolean, url?:string}>}
|
||
*/
|
||
async send(user, origin) {
|
||
if (!this.redis) return this.unavailable();
|
||
|
||
// 1) 日额度(每个邮箱每天最多 N 封)
|
||
const quota = await this.ctx.service.mailQuota.consume(user.email);
|
||
if (!quota.ok) {
|
||
return { ok: false, reason: 'daily_limit', message: quota.message };
|
||
}
|
||
|
||
const ttl = this.cfg.resetTtl;
|
||
let locked;
|
||
let token;
|
||
try {
|
||
// 2) 重发节流:同一用户 resendInterval 秒内只发一次
|
||
locked = await this.redis.set(this.sentKey(user.id), '1', 'EX', this.cfg.resendInterval, 'NX');
|
||
if (locked !== 'OK') {
|
||
await this.ctx.service.mailQuota.refund(user.email);
|
||
return {
|
||
ok: false,
|
||
reason: 'throttled',
|
||
message: `重置链接已发送,请 ${this.cfg.resendInterval} 秒后再试`,
|
||
};
|
||
}
|
||
|
||
// 先把旧链接作废,再写新链接
|
||
const old = await this.redis.get(this.userKey(user.id));
|
||
token = crypto.randomBytes(32).toString('hex');
|
||
await this.redis.setex(this.tokenKey(token), ttl, String(user.id));
|
||
await this.redis.setex(this.userKey(user.id), ttl, digest(token));
|
||
if (old) await this.redis.del(this.prefix(`token:${old}`));
|
||
} catch (err) {
|
||
this.ctx.logger.error('[reset] 生成重置令牌失败 user=%s : %s', user.id, err.message);
|
||
await this.ctx.service.mailQuota.refund(user.email).catch(() => {});
|
||
return this.unavailable();
|
||
}
|
||
|
||
const url = `${String(origin || '').replace(/\/+$/, '')}/reset?token=${token}`;
|
||
const mail = await this.ctx.service.mail.sendResetLink(user.email, url, { ttl });
|
||
if (mail.failed) {
|
||
// 发信失败:把令牌撤掉、放开节流位、还回日额度,用户稍后可立即重试
|
||
await this.redis.del(this.tokenKey(token), this.userKey(user.id), this.sentKey(user.id)).catch(() => {});
|
||
await this.ctx.service.mailQuota.refund(user.email).catch(() => {});
|
||
return { ok: false, reason: 'mail', message: '邮件发送失败,请稍后再试' };
|
||
}
|
||
|
||
this.ctx.logger.info('[reset] 重置链接已生成 user=%s email=%s(今日第 %s/%s 封)',
|
||
user.id, user.email, quota.used, quota.limit);
|
||
// 生产环境绝不回传重置链接(即使配置误开 devMode 也兜底)
|
||
const exposeDevUrl = this.app.config.env !== 'prod' && !!mail.devMode;
|
||
return { ok: true, devMode: exposeDevUrl, url: exposeDevUrl ? url : undefined };
|
||
}
|
||
|
||
/**
|
||
* 校验令牌(不改动状态)
|
||
* @param {string} token 链接里的令牌原文
|
||
* @return {Promise<number|null>} 用户 id,无效/过期返回 null
|
||
*/
|
||
async verify(token) {
|
||
if (!this.redis || !token) return null;
|
||
try {
|
||
const userId = await this.redis.get(this.tokenKey(token));
|
||
return userId ? Number(userId) : null;
|
||
} catch (err) {
|
||
this.ctx.logger.error('[reset] 校验令牌失败 : %s', err.message);
|
||
return null;
|
||
}
|
||
}
|
||
|
||
/** 消费令牌(重置成功后调用,链接随即失效) */
|
||
async consume(token, userId) {
|
||
if (!this.redis) return;
|
||
try {
|
||
await this.redis.del(this.tokenKey(token));
|
||
await this.redis.del(this.userKey(userId));
|
||
await this.redis.del(this.sentKey(userId));
|
||
} catch (err) {
|
||
this.ctx.logger.warn('[reset] 清理令牌失败 : %s', err.message);
|
||
}
|
||
}
|
||
}
|
||
|
||
module.exports = PasswordResetService;
|