packServer/backend/app/service/password_reset.js
liufumingren dd9482a3fe 注册 / 找回密码:先判邮箱占用 + 每邮箱每天最多 10 封
后端
- 新增 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>
2026-10-21 18:03:31 +08:00

148 lines
5.7 KiB
JavaScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'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;