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

233 lines
9.2 KiB
JavaScript
Raw 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 { Controller } = require('egg');
/** 邮箱格式(与页面版保持一致,宽松校验) */
const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;
/**
* web 用户端:登录 / 注册 / 找回密码 / 重置密码(**JSON 接口**,给前端 SPA 调)
*
* 鉴权走 **header 令牌**(`Authorization: Bearer <user JWT>`),不依赖 cookie/session:
* 前端与后端不同源也没问题,也天然不受 CSRF 影响(`/api/*` 不过 CSRF)。
*
* 统一响应:成功 `{ ok:true, data }`;失败 `{ ok:false, status?, message }`。
*/
class WebAuthController extends Controller {
/** 签发令牌 + 返回脱敏用户(登录 / 注册成功后都走它) */
async issue(user) {
return this.ctx.service.login.issue(user);
}
/**
* POST /api/web/auth/login
* body: `{ account, password, client?, agreements? }`
* - account 支持 用户名 / 手机号 / 邮箱
* - client = 'mini_program' 时必须同意当前协议版本(见 config.agreement.enforce)
* - agreements = `[{ code, versionId }]`,登录成功后按用户 + 版本落库
* → `{ token, tokenType, expiresIn, user, subjects, agreements? }`
*/
async login() {
const { ctx } = this;
const body = ctx.request.body || {};
const { account, password } = body;
const client = ctx.service.login.normalizeClient(body.client);
if (!account || !password) {
ctx.status = 422;
ctx.body = { ok: false, message: '请填写账号和密码' };
return;
}
let accepted = null;
if (ctx.service.login.shouldEnforceAgreement(client)) {
accepted = await ctx.service.login.requireAgreements(body.agreements);
if (!accepted) return;
}
const user = await ctx.service.auth.login(String(account).trim(), password);
if (!user) {
ctx.status = 401;
ctx.body = { ok: false, status: 'unauthorized', message: '账号或密码错误' };
return;
}
ctx.logger.info('[web] %s 登录成功(API, client=%s)', user.username || account, client || 'unknown');
const data = await this.issue(user);
if (accepted) {
data.agreements = await ctx.service.login.recordAgreements(user, accepted, client);
ctx.logger.info('[web] 用户 %s 同意协议:%s', user.id, accepted.map(item => `${item.code}@${item.version}`).join(', '));
}
ctx.body = { ok: true, data };
}
/**
* POST /api/web/auth/register/code
* body: `{ email }` → 发 6 位邮箱验证码(开发模式直接返回 `code`)
*/
async sendRegisterCode() {
const { ctx } = this;
const email = String((ctx.request.body || {}).email || '').trim().toLowerCase();
if (!ctx.app.config.register.enable) {
ctx.throw(403, '注册已关闭,请联系管理员开通账号');
}
if (!EMAIL_RE.test(email)) {
ctx.throw(422, '请填写正确的邮箱');
}
// 先判邮箱是否已被占用(大小写不敏感、含软删除账号)—— 已被占用就别发验证码了
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.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);
ctx.body = {
ok: true,
data: {
email,
// 开发模式(未配 SMTP)把验证码带回来,前端可直接提示;生产不返回
devMode: exposeDevCode,
code: exposeDevCode ? result.code : undefined,
},
};
}
/**
* POST /api/web/auth/register
* body: `{ username, email, code, password, nickname?, phone? }` → 建成即登录(返回令牌)
*/
async register() {
const { ctx } = this;
const body = ctx.request.body || {};
const username = String(body.username || '').trim();
const email = String(body.email || '').trim().toLowerCase();
const code = String(body.code || '').trim();
const password = String(body.password || '');
const nickname = String(body.nickname || '').trim();
const phone = String(body.phone || '').trim();
if (!ctx.app.config.register.enable) ctx.throw(403, '注册已关闭,请联系管理员开通账号');
if (!/^[A-Za-z0-9_]{3,32}$/.test(username)) ctx.throw(422, '用户名需 3-32 位字母、数字或下划线');
if (!EMAIL_RE.test(email)) ctx.throw(422, '邮箱格式不正确');
if (!/^\d{6}$/.test(code)) ctx.throw(422, '请填写 6 位邮箱验证码');
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);
try {
const user = await ctx.service.auth.register({ username, password, nickname, email, phone: phone || null });
// 注册成功才消费验证码(用户名/邮箱冲突时可改完重提,不用重新收码)
await ctx.service.verifyCode.consume('register', email);
ctx.logger.info('[web] %s 注册成功(API,id=%s)', username, user.id);
ctx.body = { ok: true, data: await this.issue(user) };
} catch (err) {
// 唯一键冲突(409):翻成页面能直接显示的文案
if (err.status === 409) {
const message = String(err.message || '');
ctx.status = 409;
ctx.body = {
ok: false,
message: message.startsWith('username') ? '该用户名已被使用'
: message.startsWith('email') ? '该邮箱已被使用'
: message.startsWith('phone') ? '该手机号已被注册'
: '注册失败,请稍后重试',
};
return;
}
throw err;
}
}
/**
* 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.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' || result.reason === 'daily_limit' ? 429 : 503;
ctx.body = { ok: false, status: result.reason || 'error', message: result.message };
return;
}
ctx.logger.info('[web] 已向 %s 发送重置密码链接', email);
const exposeDevUrl = ctx.app.config.env !== 'prod' && Boolean(result.devMode);
ctx.body = {
ok: true,
data: {
sent: true,
// 开发模式(未配 SMTP)把链接返回,前端可直接点开
devMode: exposeDevUrl,
url: exposeDevUrl ? result.url : undefined,
},
};
return;
}
if (user) ctx.logger.warn('[web] 账号已禁用,不发送重置链接: %s', email);
ctx.body = { ok: true, data: { sent: true } };
}
/**
* POST /api/web/auth/reset
* body: `{ token, password }` → 用邮件里的令牌设新密码(令牌一次性)
*/
async reset() {
const { ctx } = this;
const body = ctx.request.body || {};
const token = String(body.token || '');
const password = String(body.password || '');
const userId = await ctx.service.passwordReset.verify(token);
if (!userId) ctx.throw(410, '重置链接无效或已过期,请重新获取');
if (password.length < 6) ctx.throw(422, '密码至少 6 位');
await ctx.service.auth.setPassword(userId, password);
await ctx.service.passwordReset.consume(token, userId);
ctx.logger.info('[web] 用户 %s 通过邮件链接重置了密码(API)', userId);
ctx.body = { ok: true, data: { id: userId } };
}
}
module.exports = WebAuthController;