diff --git a/backend/README.md b/backend/README.md index 2f467a5..a1ba26f 100644 --- a/backend/README.md +++ b/backend/README.md @@ -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:`,TTL `EMAIL_CODE_TTL`,默认 10 分钟);重发节流(`SET NX`,默认 60 秒);错试超过 `EMAIL_CODE_ATTEMPTS`(默认 5 次)作废;**注册成功才消费验证码**(用户名/邮箱冲突时可改完重提,不用重新收码); + - **每日发信上限**:`packs:mailquota::`(`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`(有反代/多域名时更可靠); diff --git a/backend/app/controller/web/auth.js b/backend/app/controller/web/auth.js index a0e87f0..001dd4c 100644 --- a/backend/app/controller/web/auth.js +++ b/backend/app/controller/web/auth.js @@ -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; } diff --git a/backend/app/service/mail_quota.js b/backend/app/service/mail_quota.js new file mode 100644 index 0000000..bf16783 --- /dev/null +++ b/backend/app/service/mail_quota.js @@ -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::` 当天已发次数(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; diff --git a/backend/app/service/password_reset.js b/backend/app/service/password_reset.js index c38592f..1f167ec 100644 --- a/backend/app/service/password_reset.js +++ b/backend/app/service/password_reset.js @@ -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::` 当日发信次数(`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 }; diff --git a/backend/app/service/user.js b/backend/app/service/user.js index 8d7de55..51cb522 100644 --- a/backend/app/service/user.js +++ b/backend/app/service/user.js @@ -35,6 +35,41 @@ class UserService extends Service { return user ? user.toJSON() : null; } + /** + * 按邮箱查用户(**大小写不敏感**,且包含已软删除的账号) + * + * 为什么要这样查: + * - 用户可能存成 `Foo@X.com`,注册时输入 `foo@x.com` → 直接等值比较会漏, + * 于是「邮箱已被使用」校验失效,验证码白发了(最终还会在插入时撞唯一键); + * - 软删除的账号仍占着唯一索引,注册也必须算「已被使用」。 + * + * @param {string} email 邮箱 + * @return {Promise} 用户(普通对象,不含密码哈希;软删除的也能查到) + */ + 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} Sequelize 实例 diff --git a/backend/app/service/verify_code.js b/backend/app/service/verify_code.js index 1eeb08e..7a94dd9 100644 --- a/backend/app/service/verify_code.js +++ b/backend/app/service/verify_code.js @@ -17,6 +17,7 @@ function randomCode() { * - `packs:verify::` 验证码本身(TTL = config.email.codeTtl,默认 10 分钟) * - `packs:verify:::sent` 重发节流标记(SET NX,TTL = resendInterval,默认 60 秒) * - `packs:verify:::try` 错误次数(超过 maxAttempts 作废验证码) + * - `packs:mailquota::` 当日发信次数(见 `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: '验证码服务暂不可用,请稍后再试' }; } } diff --git a/backend/config/config.default.js b/backend/config/config.default.js index 91bdbed..3e53b68 100644 --- a/backend/config/config.default.js +++ b/backend/config/config.default.js @@ -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) diff --git a/backend/test/app/controller/web.test.js b/backend/test/app/controller/web.test.js index c0d0cfd..4d85d22 100644 --- a/backend/test/app/controller/web.test.js +++ b/backend/test/app/controller/web.test.js @@ -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); diff --git a/backend/test/utils/fake-redis.js b/backend/test/utils/fake-redis.js index 790e749..795da0e 100644 --- a/backend/test/utils/fake-redis.js +++ b/backend/test/utils/fake-redis.js @@ -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); diff --git a/frontend/src/views/ForgotView.vue b/frontend/src/views/ForgotView.vue index 8c53305..23d25ba 100644 --- a/frontend/src/views/ForgotView.vue +++ b/frontend/src/views/ForgotView.vue @@ -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; diff --git a/frontend/src/views/LoginView.vue b/frontend/src/views/LoginView.vue index 4eccbaa..9ef7c5c 100644 --- a/frontend/src/views/LoginView.vue +++ b/frontend/src/views/LoginView.vue @@ -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;