注册 / 找回密码:先判邮箱占用 + 每邮箱每天最多 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>
This commit is contained in:
liufumingren 2026-10-21 18:03:31 +08:00
parent 3030f50cd3
commit dd9482a3fe
11 changed files with 315 additions and 17 deletions

View File

@ -392,6 +392,7 @@ npm run cov
| `EMAIL_CODE_TTL` | `600` | 邮箱验证码有效期(秒) |
| `EMAIL_CODE_RESEND` | `60` | 同一邮箱重发验证码的间隔(秒) |
| `EMAIL_CODE_ATTEMPTS` | `5` | 同一个验证码最多校验几次(超过则作废) |
| `EMAIL_DAILY_LIMIT` | `10` | **每个邮箱每天最多发几封邮件**(注册验证码 + 找回密码共用,超出提示「明天再试」) |
| `EMAIL_RESET_TTL` | `1800` | 重置密码链接有效期(秒,默认 30 分钟) |
| `SITE_URL` | 空 | 邮件里重置链接的站点地址(如 `https://packs.example.com`);不配则用当前请求的 host |
| `WECHAT_APPID` | 空 | 微信开放平台网站应用 appid;**不配时登录页二维码退化为本地演示码**(不会假装能用) |
@ -789,7 +790,9 @@ await this.ctx.service.cache.remember('user:1', 60, () => loadFromMysql());
- **登录账号支持 用户名 / 手机号 / 邮箱**(`service.user.findByAccount()` 的 `Op.or` 同时匹配 `username` / `phone` / `email`);邮箱也能在个人中心修改(同样格式校验 + 小写归一 + 唯一性检查);用户列表的 `keyword` 也搜邮箱;
- 注册开关 `config.register.enable`(环境变量 `REGISTER_ENABLED`,默认开):关掉后发码与注册接口都返回 403「注册已关闭」;这是面向内部管理的服务,**上线建议关闭**并用 `npm run user:pass` 建号;
- **注册必须验证邮箱**(邮箱必填):两步——`POST /api/web/auth/register/code` 发 6 位验证码 → `POST /api/web/auth/register` 带 `code` 校验通过才能建号。
- **发码前先判邮箱是否已被占用**:`service.user.findByEmail()` 用 `LOWER(email) = ?` 查(**大小写不敏感**)+ `paranoid: false`(软删除账号仍占唯一键),命中就直接 409 `email_taken`「该邮箱已被使用…」,**一封邮件都不发**;提交注册时再判一次(防止发码后被别人抢先注册);
- 验证码存 Redis(`packs:verify:register:<email>`,TTL `EMAIL_CODE_TTL`,默认 10 分钟);重发节流(`SET NX`,默认 60 秒);错试超过 `EMAIL_CODE_ATTEMPTS`(默认 5 次)作废;**注册成功才消费验证码**(用户名/邮箱冲突时可改完重提,不用重新收码);
- **每日发信上限**:`packs:mailquota:<email>:<yyyy-MM-dd>`(`service/mail_quota.js`),**同一邮箱每天最多 `EMAIL_DAILY_LIMIT`(默认 10)封**,注册验证码与找回密码**共用**这个额度;超出返回 429 `daily_limit`「该邮箱今天已发送 10 封邮件,达到上限,请明天再试」;按北京时间(UTC+8)切日,key 的 TTL 到当天 24 点自动过期。发信失败 / 被 60 秒节流拦下会把额度还回去;
- 发信走 `app/service/mail.js`:**未配 `SMTP_HOST` 时是开发模式**(验证码写服务端日志 + 在接口返回里带 `code`,前端直接提示,仅本地/测试);配上 `SMTP_HOST/PORT/USER/PASSWORD/FROM` 后自动改用 nodemailer 真发信(依赖懒加载);
- 验证码逻辑不抛异常,统一返回 `{ ok, message }`,失败都是接口报错(Redis 不可用会提示“验证码服务暂不可用”而不是 500);
- **邮箱找回密码(发重置链接)**:前端「忘记密码?」页 → `POST /api/web/auth/forgot` 生成带令牌的链接并**发到邮箱** → 邮件里的链接打开前端 `/reset?token=...` 设置新密码 → `POST /api/web/auth/reset` 改哈希(**不自动登录**,要求用新密码再登一次)。
@ -804,7 +807,9 @@ await this.ctx.service.cache.remember('user:1', 60, () => loadFromMysql());
- **Redis 里只存令牌的 sha256 摘要,不存原文**(泄库也拿不到可用的链接;令牌本身是 `randomBytes(32)` 的 64 位 hex);
- **有效期是固定的 30 分钟**(不滑动:`verify()` 不续期);**一次性**:重置成功后 `consume()` 删掉令牌;**重新申请会让旧链接立刻失效**(同一用户只保留最新一条);校验失败的提交(密码太短/两次不一致/令牌不对)**不会**消费令牌;
- **重发节流 60 秒**:命中时 `/forgot` 返回 **429** + `{ ok:false, status:'throttled', message:'重置链接已发送,请 60 秒后再试' }`(⚠️ 2026-10-17 修:以前抛 500,被 error_handler 盖成「服务器内部错误」,用户看不懂);Redis 写失败/发信失败 → **503** + `status:'unavailable' | 'mail'`;
- **重发节流 60 秒**:命中时 `/forgot` 返回 **429** + `{ ok:false, status:'throttled', message:'重置链接已发送,请 60 秒后再试' }`(⚠️ 2026-10-17 修:以前抛 500,被 error_handler 盖成「服务器内部错误」,用户看不懂);
- **每日发信上限(与注册验证码共用额度)**:同一邮箱每天最多 `EMAIL_DAILY_LIMIT`(默认 10)封,超出返回 **429** + `{ status:'daily_limit', message:'该邮箱今天已发送 10 封邮件,达到上限,请明天再试' }`,**不生成令牌也不发信**(防止被反复点击骚扰收件人 / 刷爆 SMTP 配额);按北京时间(UTC+8)切日;
- 用户按邮箱查也走 `service.user.findByEmail()`(**大小写不敏感 + 含软删除**),避免换个大小写就绕过额度或漏发;Redis 写失败/发信失败 → **503** + `status:'unavailable' | 'mail'`;
- **防账号枚举**:邮箱格式不对才报错;邮箱未注册或账号被禁用时,提示与成功完全一致(“如果该邮箱已注册,链接已经发出”),并且不发信;
- 邮件正文由 `service.mail.sendResetLink()` 生成(与验证码同一套开发模式/SMTP 逻辑:未配 `SMTP_HOST` 时链接写日志 + 接口返回 `url`,前端直接给个可点链接,方便本地点开);
- 链接地址默认取当前请求的 host,正式部署建议配 `SITE_URL`(有反代/多域名时更可靠);

View File

@ -75,11 +75,27 @@ class WebAuthController extends Controller {
ctx.throw(422, '请填写正确的邮箱');
}
const exists = await ctx.service.user.findOneBy({ email });
if (exists) ctx.throw(409, '该邮箱已被使用');
// 先判邮箱是否已被占用(大小写不敏感、含软删除账号)—— 已被占用就别发验证码了
if (await ctx.service.user.emailExists(email)) {
ctx.status = 409;
ctx.body = {
ok: false,
status: 'email_taken',
message: '该邮箱已被使用,请换一个邮箱或直接登录(忘记密码可在登录页找回)',
};
return;
}
const result = await ctx.service.verifyCode.send('register', email);
if (!result.ok) ctx.throw(429, result.message);
if (!result.ok) {
ctx.status = 429;
ctx.body = {
ok: false,
status: result.reason || 'send_failed',
message: result.message,
};
return;
}
ctx.logger.info('[web] 注册验证码已发送到 %s', email);
const exposeDevCode = ctx.app.config.env !== 'prod' && Boolean(result.devMode);
@ -115,6 +131,13 @@ class WebAuthController extends Controller {
if (password.length < 6) ctx.throw(422, '密码至少 6 位');
if (phone && !/^[0-9+\-]{6,20}$/.test(phone)) ctx.throw(422, '手机号格式不正确');
// 提交时再判一次邮箱占用(大小写不敏感、含软删除):发码后被别人抢先注册也能给明确文案
if (await ctx.service.user.emailExists(email)) {
ctx.status = 409;
ctx.body = { ok: false, status: 'email_taken', message: '该邮箱已被使用,请换一个邮箱' };
return;
}
const checked = await ctx.service.verifyCode.check('register', email, code);
if (!checked.ok) ctx.throw(422, checked.message);
@ -145,20 +168,24 @@ class WebAuthController extends Controller {
/**
* POST /api/web/auth/forgot
* body: `{ email }` → 发重置链接(**防账号枚举**:邮箱没注册也返回成功)
*
* 每天同一邮箱最多发 `config.email.dailyLimit` 封(默认 10,与注册验证码共用额度),
* 超出返回 429「今天已达上限,请明天再试」,避免被反复点击骚扰收件人。
*/
async forgot() {
const { ctx } = this;
const email = String((ctx.request.body || {}).email || '').trim().toLowerCase();
if (!EMAIL_RE.test(email)) ctx.throw(422, '请填写正确的邮箱');
const user = await ctx.service.user.findOneBy({ email });
// 大小写不敏感 + 含软删除,避免同一邮箱换个大小写绕过额度
const user = await ctx.service.user.findByEmail(email);
if (user && Number(user.status) === 1) {
const origin = ctx.app.config.email.siteUrl || ctx.origin;
const result = await ctx.service.passwordReset.send(user, origin);
if (!result.ok) {
// 直接回状态码 + 原文(不走 ctx.throw:5xx 会被 error_handler 盖成「服务器内部错误」)
// 节流 → 429(前端把 message 展示给用户);Redis/发信异常 → 503
ctx.status = result.reason === 'throttled' ? 429 : 503;
// 日额度/重发节流 → 429(前端把 message 展示给用户);Redis/发信异常 → 503
ctx.status = result.reason === 'throttled' || result.reason === 'daily_limit' ? 429 : 503;
ctx.body = { ok: false, status: result.reason || 'error', message: result.message };
return;
}

View File

@ -0,0 +1,128 @@
'use strict';
const { Service } = require('egg');
/** 每天额度按北京时间(UTC+8)切日,避免服务器时区不同导致「第二天」算错 */
const DAY_OFFSET_MS = 8 * 3600 * 1000;
/**
* 邮件发送日额度(每个邮箱每天最多 N 封)
*
* 注册验证码、找回密码重置链接**共用同一个额度**(同一个邮箱一天最多 `config.email.dailyLimit` 封,默认 10),
* 超出直接拒绝,提示「明天再试」—— 防止被人拿一个邮箱刷爆发信配额 / 骚扰收件人。
*
* 存 Redis:
* - `packs:mailquota:<email>:<yyyy-MM-dd>` 当天已发次数(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;

View File

@ -18,6 +18,7 @@ function digest(token) {
* - `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)。
@ -54,20 +55,31 @@ class PasswordResetService extends Service {
/**
* 生成重置链接并发送邮件(同一个用户只保留最新一条链接,旧链接立即失效)
*
* 发信前先占「每日额度」(同一邮箱每天最多 `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, devMode?:boolean, url?:string}>}
* @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 {
// 重发节流:同一用户 resendInterval 秒内只发一次
// 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',
@ -83,18 +95,21 @@ class PasswordResetService extends Service {
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', user.id, user.email);
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 };

View File

@ -35,6 +35,41 @@ class UserService extends Service {
return user ? user.toJSON() : null;
}
/**
* 按邮箱查用户(**大小写不敏感**,且包含已软删除的账号)
*
* 为什么要这样查:
* - 用户可能存成 `Foo@X.com`,注册时输入 `foo@x.com` → 直接等值比较会漏,
* 于是「邮箱已被使用」校验失效,验证码白发了(最终还会在插入时撞唯一键);
* - 软删除的账号仍占着唯一索引,注册也必须算「已被使用」。
*
* @param {string} email 邮箱
* @return {Promise<object|null>} 用户(普通对象,不含密码哈希;软删除的也能查到)
*/
async findByEmail(email) {
const normalized = String(email || '').trim().toLowerCase();
if (!normalized) return null;
// LOWER(email) = ? 保证大小写不敏感(不依赖列排序规则);
// 单测里 sequelize 插件是关掉的(app.Sequelize 不存在),这时退化成等值查询
const sequelize = this.User.sequelize || this.app.Sequelize;
const where = sequelize && typeof sequelize.where === 'function' && typeof sequelize.fn === 'function'
? sequelize.where(sequelize.fn('lower', sequelize.col('email')), normalized)
: { email: normalized };
const user = await this.User.findOne({
where,
attributes: SAFE_ATTRIBUTES,
paranoid: false, // 软删除的账号仍占用邮箱唯一键
});
return user ? user.toJSON() : null;
}
/** 邮箱是否已被使用(注册发验证码前先查它,避免白发一封邮件) */
async emailExists(email) {
return Boolean(await this.findByEmail(email));
}
/**
* 登录用:按用户名 / 手机号 / 邮箱查询,包含密码哈希(仅鉴权内部使用,不要外传)
* @return {Promise<object|null>} Sequelize 实例

View File

@ -17,6 +17,7 @@ function randomCode() {
* - `packs:verify:<scene>:<email>` 验证码本身(TTL = config.email.codeTtl,默认 10 分钟)
* - `packs:verify:<scene>:<email>:sent` 重发节流标记(SET NX,TTL = resendInterval,默认 60 秒)
* - `packs:verify:<scene>:<email>:try` 错误次数(超过 maxAttempts 作废验证码)
* - `packs:mailquota:<email>:<date>` 当日发信次数(见 `service/mail_quota.js`,默认每天 10 封)
*
* 对外不抛异常,统一返回 `{ ok, message }`,方便页面回提示(不弹 500)。
*/
@ -36,18 +37,32 @@ class VerifyCodeService extends Service {
/**
* 生成验证码并发邮件
*
* 顺序(都很重要):
* 1. **日额度**:同一邮箱一天最多 `config.email.dailyLimit` 封(默认 10),超出直接拒绝,不发信;
* 2. **重发节流**:`resendInterval` 秒内只发一次(被拦下会把刚占的日额度还回去);
* 3. 真正发信;发失败同样还额度,避免用户被自己的失败重试耗光当天次数。
*
* @param {string} scene 场景(register)
* @param {string} email 邮箱(调用方保证已小写归一)
* @return {Promise<{ok:boolean, message?:string, code?:string, devMode?:boolean, ttl?:number, resendInterval?:number}>}
* @return {Promise<{ok:boolean, message?:string, reason?:string, code?:string, devMode?:boolean, ttl?:number, resendInterval?:number}>}
*/
async send(scene, email) {
if (!this.redis) return { ok: false, message: '验证码服务不可用(Redis 未就绪)' };
const key = this.keyOf(scene, email);
// 1) 日额度(每个邮箱每天最多 N 封)
const quota = await this.ctx.service.mailQuota.consume(email);
if (!quota.ok) {
return { ok: false, reason: 'daily_limit', message: quota.message };
}
try {
// 重发节流:SET NX 原子占位,间隔内只允许发一次
// 2) 重发节流:SET NX 原子占位,间隔内只允许发一次
const locked = await this.redis.set(`${key}:sent`, '1', 'EX', this.cfg.resendInterval, 'NX');
if (locked !== 'OK') {
await this.ctx.service.mailQuota.refund(email);
return { ok: false, message: `验证码已发送,请 ${this.cfg.resendInterval} 秒后再试` };
}
@ -58,22 +73,26 @@ class VerifyCodeService extends Service {
const mail = await this.ctx.service.mail.sendVerifyCode(email, code, { ttl: this.cfg.codeTtl });
if (mail.failed) {
await this.redis.del(`${key}:sent`); // 发失败就不要占着节流位
await this.ctx.service.mailQuota.refund(email);
return { ok: false, message: '验证码邮件发送失败,请稍后再试' };
}
this.ctx.logger.info('[verify] %s 验证码已生成: %s (devMode=%s)', scene, email, !!mail.devMode);
this.ctx.logger.info('[verify] %s 验证码已生成: %s (devMode=%s, 今日第 %s/%s 封)',
scene, email, !!mail.devMode, quota.used, quota.limit);
// 生产环境绝不回传验证码(即使配置误开 devMode 也兜底)
const exposeDevCode = this.app.config.env !== 'prod' && !!mail.devMode;
return {
ok: true,
ttl: this.cfg.codeTtl,
resendInterval: this.cfg.resendInterval,
remaining: quota.remaining,
devMode: exposeDevCode,
// 开发模式才把验证码回传给页面(生产走邮件)
code: exposeDevCode ? code : undefined,
};
} catch (err) {
this.ctx.logger.error('[verify] 验证码发送失败 %s : %s', email, err.message);
await this.ctx.service.mailQuota.refund(email).catch(() => {});
return { ok: false, message: '验证码服务暂不可用,请稍后再试' };
}
}

View File

@ -231,6 +231,8 @@ module.exports = (appInfo) => {
codeTtl: Number(env.EMAIL_CODE_TTL || 600),
resendInterval: Number(env.EMAIL_CODE_RESEND || 60),
maxAttempts: Number(env.EMAIL_CODE_ATTEMPTS || 5),
// 每个邮箱每天最多发几封验证码 / 重置邮件(跨场景共享,超出要等第二天)
dailyLimit: Number(env.EMAIL_DAILY_LIMIT || 10),
// 重置密码链接有效期(秒,默认 30 分钟)
resetTtl: Number(env.EMAIL_RESET_TTL || 1800),
// 邮件里链接用的站点地址(不配就用请求里的 host)

View File

@ -194,6 +194,51 @@ describe('test/app/controller/web.test.js', () => {
assert(/秒后再试/.test(again.body.message), JSON.stringify(again.body));
});
it('POST /api/web/auth/forgot:同一邮箱当天超过 10 封 → 429,提示明天再试', async () => {
const fake = createFakeRedis();
mock(app, 'redis', fake.client);
mockUser();
// 直接把当日额度打到上限(模拟已经发过 10 封)
const limit = app.config.email.dailyLimit;
const day = app.createAnonymousContext().service.mailQuota.today();
await fake.client.set(`${app.config.cache.prefix}mailquota:${userRow.email}:${day}`, String(limit));
const res = await app.httpRequest().post('/api/web/auth/forgot').send({ email: userRow.email }).expect(429);
assert(res.body.status === 'daily_limit', JSON.stringify(res.body));
assert(/明天再试/.test(res.body.message), JSON.stringify(res.body));
});
it('POST /api/web/auth/register/code:邮箱已使用 → 409,且不再发验证码', async () => {
const fake = createFakeRedis();
mock(app, 'redis', fake.client);
mockUser();
const res = await app.httpRequest().post('/api/web/auth/register/code').send({ email: userRow.email }).expect(409);
assert(res.body.status === 'email_taken', JSON.stringify(res.body));
assert(/已被使用/.test(res.body.message), JSON.stringify(res.body));
// 没有占用任何发信额度(说明压根没发)
const day = app.createAnonymousContext().service.mailQuota.today();
const used = await fake.client.get(`${app.config.cache.prefix}mailquota:${userRow.email}:${day}`);
assert(!used, `邮箱已占用时不应发信,实际额度记录=${used}`);
});
it('POST /api/web/auth/register/code:新邮箱当天超过 10 封 → 429,提示明天再试', async () => {
const fake = createFakeRedis();
mock(app, 'redis', fake.client);
mock(app, 'model', { User: { async findOne() { return null; } } });
const email = 'newbie@example.com';
const limit = app.config.email.dailyLimit;
const day = app.createAnonymousContext().service.mailQuota.today();
await fake.client.set(`${app.config.cache.prefix}mailquota:${email}:${day}`, String(limit));
const res = await app.httpRequest().post('/api/web/auth/register/code').send({ email }).expect(429);
assert(res.body.status === 'daily_limit', JSON.stringify(res.body));
assert(/明天再试/.test(res.body.message), JSON.stringify(res.body));
});
it('改密 / 重置密码后,旧 user JWT 立即失效(password_changed_at)', async () => {
const user = Object.assign({}, userRow, { passwordChangedAt: null });
mock(app, 'redis', createFakeRedis().client);

View File

@ -80,6 +80,11 @@ module.exports = function createFakeRedis() {
store.set(key, String(next));
return next;
},
async decr(key) {
const next = Number(alive(key) ? store.get(key) : 0) - 1;
store.set(key, String(next));
return next;
},
async expire(key, ttl) {
if (!alive(key)) return 0;
expires.set(key, Date.now() + Number(ttl) * 1000);

View File

@ -11,11 +11,21 @@ const devUrl = ref('');
async function submit() {
error.value = '';
const target = email.value.trim().toLowerCase();
if (!target) {
error.value = '请填写邮箱';
return;
}
if (!/^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/.test(target)) {
error.value = '请填写正确的邮箱';
return;
}
busy.value = true;
try {
// 后端节流:60 秒内只能发一次;同一邮箱每天最多 10 封,超出提示明天再试(429)
const data = await api.post<{ sent: boolean; devMode: boolean; url?: string }>(
'/api/web/auth/forgot',
{ email: email.value },
{ email: target },
{ auth: false },
);
sent.value = data.sent;

View File

@ -71,15 +71,22 @@ async function doLogin() {
async function sendCode() {
error.value = '';
ok.value = '';
if (!registerForm.email) {
const email = registerForm.email.trim().toLowerCase();
if (!email) {
error.value = '请先填写邮箱';
return;
}
// 本地先校验格式,避免明显不合法的邮箱也去打接口
if (!/^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/.test(email)) {
error.value = '请填写正确的邮箱';
return;
}
busy.value = true;
try {
// 后端会先判邮箱是否已被占用(409),再判「同一邮箱每天最多 10 封」(429)
const data = await api.post<{ devMode: boolean; code?: string }>(
'/api/web/auth/register/code',
{ email: registerForm.email },
{ email },
{ auth: false },
);
codeSent.value = true;