跳到主要内容

第 19 期 · 对照 BS 的全量审查与修复

· 阅读需 5 分钟

进入 M4 之前,对照 Blessing Skin 的源码和设计文档 01–06、ADR 0001–0026,把 SkinLoom 的架构和代码从头审查了一遍。对外协议(CSL、USM、Legacy、Yggdrasil、OAuth 与 /api/*)的路由和 BS 逐条对得上,整体方向没有要回退的地方。问题集中在并发:六个问题都用并发测试在 SQLite 和 PostgreSQL 上复现,然后一并修掉。

复现了什么​

审查时临时写了几个并发测试,基于修复前的接口,复现后删除:

场景修复前
同时发出几次"改为私有"(双击)6 个请求扣了 6 次差价
给角色穿上材质,同时把它移出衣柜角色穿着不在衣柜里的材质(SQLite 150 轮 149 次)
删除角色,同时把它穿着的材质移出衣柜PostgreSQL 60 轮 59 次死锁
删除上传者账号,同时有人收藏他的材质死锁;收藏常因给已删除的上传者发奖励而报 500
两位管理员同时保存有重叠键的设置PostgreSQL 200 次保存 130 次死锁
同一时刻发出一批错误密码200 个请求全部做了密码校验,限额是 10

前五个的根源相同:事务里的判断用的是事务开始前读到的数据;ADR 0026 的加锁顺序只覆盖改积分的事务,删角色、删用户、保存设置都不在里面。最后一个是"先检查、做完密码哈希再计数",并发请求都在计数之前通过了检查。

怎么修的(ADR 0027)​

  • 加锁之后再判断:材质先锁住再重读,可见性、上传者、类型都按锁里读到的值。穿戴和转移角色先锁住相关材质,再查衣柜。
  • 加锁层级扩展:材质 → 用户 → 角色 → 其它。删角色先锁主人。删用户的钩子挪进删号事务,先锁他的材质、再锁用户;期间账号被恢复时整个事务回滚,私有材质不会被提前删掉。
  • 设置按键名顺序写入。
  • 限流一步完成:Limiter.Take 检查和计数在同一把锁里,成功登录再撤回。所有"检查、做事、计数"的地方都换成了它。
  • 顺带修的同类问题:删号时衣柜被外键删除,收藏数没减(BS C04 回来了);删除材质时上传者自己角色的槽位由外键清空,Last-Modified 不变,/{name}.json 一直回 304;SQLite 的 DSN 带参数时外键被静默关闭。

补上的地基(ADR 0028)​

  • 领域事件:Hook 总线原来只有 settings.changed。现在按设计文档 05 §4.4 的目录声明了用户、角色、材质、衣柜、举报五类共 15 个事件,在变更的事务里写进任务队列(outbox),提交后投递,至少一次。没有监听者时不写任何东西,所以现在零开销。Guard 和 Filter 随插件运行时一起做。
  • 审计和变更同事务:管理操作原来先调用服务、再在事务外写审计。现在服务直接接收审计记录,在自己的事务里写入。管理员同时改名和转移角色也合成了一个事务,原来可能只成功一半。

暂存代码复查​

修完之后又把暂存的全部改动从头复查了一遍,逐个列出每个改动过的事务的加锁顺序。又找到三处问题,都先写测试、确认失败,再修:

  • 处理举报仍是先读举报、再开事务。举报人在这期间被删除时,奖励会发给已删除的账号,返回 500。现在加锁之后重读。
  • 删除材质时清空穿戴槽位用的是 IN (所有角色 id),7 万个角色穿着的材质删不掉(SQLite 报 "too many SQL variables")。现在按条件更新。
  • 加锁覆盖不到删号的同一瞬间账号主人新收藏的那一条。补上设计文档里一直有、ADR 0019 推迟了的每日被收藏数校准。

两点记进 ADR 0028,留到上线插件之前处理:事件和邮件共用一个顺序执行的任务执行器;材质事件里有私有材质的 hash。

验证​

  • 每个问题都有对应的回归测试:并发改私有只扣一次、收藏与改私有并发、穿戴与移出衣柜并发、删角色与移出衣柜并发、删用户与收藏并发、并发保存设置、成批错误密码、删号钩子回滚、事件只在提交后存在、SQLite DSN、举报人已被删除、7 万个角色穿着的材质、被收藏数校准。在 SQLite 和 PostgreSQL 上全部通过,并发测试在 PostgreSQL 上用 -count=10 重复。
  • go vet、完整的 go test ./...(SQLite + PostgreSQL)、前端类型检查与单测。
  • 用 skinloom serve 起了真实服务,走了登录爆破、改私有、穿戴、删号等流程。

仍未验证​

  • MySQL 只在 CI 里跑:本机没有 Docker。
  • staticcheck、govulncheck 交给 CI。

下期计划​

进入 M4。