Files
moyi-model-intelligence-hub/docs/27-verified-account-transactions.md
T

38 lines
4.4 KiB
Markdown
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.
# 验证码与账号事务
日期: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。