'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::` 当日发信次数(`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} 用户 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;