Files
moyi-model-intelligence-hub/docs/27-verified-account-transactions.md
xpp ba5dbc195e
Repository verification / backend (push) Canceled after 0s
Repository verification / frontend (push) Canceled after 0s
fix:"隔离验证码投递并统一密码重置受理"
2026-10-22 08:49:04 +08:00

4.5 KiB
Raw Permalink Blame History

验证码与账号事务

日期: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 对不存在账号提前返回,对存在账号可能暴露限速/发送错误差异,且短信/邮件调用持事务锁。2026-10-22 的后续增量已分离加密异步投递、统一请求端处理与配额、清理过期记录,详见 28-verification-delivery-isolation.md。真实投递时序、SDK 期限、管理敏感操作二次验证及完整授权审查仍需继续;未做付费请求、部署或生产迁移。

用户指定的规格驱动功能验收仍受共享 testingflow 虚拟环境缺失 Python 阻塞,详见 26 号文档。本次仅为源码、单元/数据库集成回归,不能称作 qa run --project 验收通过。修复共享环境与人工审阅 draft 规格仍是正式执行前置条件。只对已审阅且验证通过的本任务改动创建本地 Git 提交,绝不 push。