38 lines
4.4 KiB
Markdown
38 lines
4.4 KiB
Markdown
# 验证码与账号事务
|
||
|
||
日期:2026-10-21。范围为公开注册和密码重置的本地事务一致性,不包含真实短信/邮件发送、生产用户操作或完整认证安全验收。
|
||
|
||
## 缺陷与修复
|
||
|
||
此前 `AuthController` 先调用 `VerificationService.consume/consumeReset` 并提交消费,再调用独立事务里的账号操作。即使邀请码无效、显示名称不合法、账号已存在、账号停用或后续审计失败,正确验证码也已经消耗,造成失败后无法重试。简单给外层加默认事务又会让错误验证码次数随异常一起回滚,破坏原有五次上限。
|
||
|
||
新增 `auth.VerifiedAccountService` 作为公开注册/恢复流程的应用事务边界:
|
||
|
||
1. 新密码策略先校验,不因弱密码消耗验证码。
|
||
2. 开启本次操作拥有的 `REQUIRES_NEW` 事务,验证码行锁、消费和账号业务在同一事务中完成。入口仅用于公开操作,不应嵌入其他业务事务;若未来复用,须重新审查连接池预算及锁顺序,避免持外层连接等待新连接。
|
||
3. 验证码失败时,仅将已知校验异常作为结果返回,让事务正常提交尝试计数,再在事务结束后向调用方抛出。尚未调用任何账号修改,不会创建用户或撤销会话;外层调用者回滚也不能抹去错误次数。`VerificationService` 原有 `noRollbackFor=ApiException` 语义保持不变。
|
||
4. 验证成功后不捕获业务/审计/存储异常。邀请码消费、兑换记录、用户/密码、会话和审计任一步失败,连同本次成功验证码消费一起回滚;没有补偿式重置验证码,也没有失去行锁后再尝试恢复状态。
|
||
5. Controller 不再自行拼接消费和业务写入。注册 Cookie 只在事务成功后签发;重置成功撤销原账号全部服务端浏览器会话,并清理响应中的会话 Cookie,失败不清 Cookie。API Key 不因本增量自动撤销。
|
||
|
||
## 验证
|
||
|
||
新增 `VerifiedAccountPostgresTest`,共 12 项真实 PostgreSQL 回归:
|
||
|
||
- 无效邀请码、显示名称过长、重复账号时有效验证码保持可用。
|
||
- 注册审计故障注入后,验证码、用户、会话、邀请码计数和兑换记录全部回滚;排除故障后同一码可成功。
|
||
- 重置审计故障注入后,验证码、密码哈希和会话撤销全部回滚;排除故障后可成功,旧会话失效。
|
||
- 注册与重置的错误码尝试计数各达到五次,外层事务回滚仍不丢计数,正确码随后被拒绝。
|
||
- 注册与重置弱密码不消费验证码;停用账号重置失败也不消耗正确码。
|
||
- 注册与重置并发消费同一码都恰好成功一次,另一次返回验证码已失效,审计/兑换不重复。
|
||
- HTTP 重置失败保留原 Cookie 和有效会话;成功返回 204、清 Cookie 且服务端会话撤销。
|
||
|
||
针对测试 `mvn -B -o -Dtest=VerifiedAccountPostgresTest test`:12 项通过,0 失败/错误/跳过。修正了新测试中的 Java 正则转义和遗漏邀请码创建者的 fixture 后重新执行,未跳过失败用例、未降低断言或放宽数据库约束。
|
||
|
||
最终完整后端命令 `mvn -B -o clean verify`:**368 项,0 失败、0 错误、0 跳过,JAR 构建成功**。结束时间为 2026-10-21 23:05:46(Asia/Shanghai)。Java 21 / Maven 3.9.9 与独立 PostgreSQL 15.18、Redis 7 测试容器,不连接业务库、不对外映射测试数据库端口。原有认证、角色、MFA、媒体 TLS/DNS、任务隔离、幂等、核账和钱包回归均参与执行。日志 `.tools/verified-account-final-verify.log` 被忽略。前端未修改,本轮先前 `npm run build` 和 `npm test` 已通过,25 项测试。
|
||
|
||
## 保留的待办
|
||
|
||
这不是注册/找回密码的全部安全闭环。`sendReset` 对不存在账号提前返回,对存在账号可能暴露限速/发送错误差异,仍需统一可观察语义与资源预算;短信/邮件调用持事务锁的设计、发送失败和超时、验证码行生命周期、管理敏感操作二次验证也要继续审查。未做真实发送、付费请求、部署或生产迁移。
|
||
|
||
用户指定的规格驱动功能验收仍受共享 `testingflow` 虚拟环境缺失 Python 阻塞,详见 26 号文档。本次仅为源码、单元/数据库集成回归,不能称作 `qa run --project` 验收通过。修复共享环境与人工审阅 draft 规格仍是正式执行前置条件。只对已审阅且验证通过的本任务改动创建本地 Git 提交,绝不 push。
|