跳到主要内容

第 25 期 · M4 全量审查

· 阅读需 4 分钟

M4 五个部分完成后,对全部改动(157 个文件)做了一次审查,分五个方向:设置中心与邮箱验证、外观与系统状态、CDN/备份/系统服务、前端、部署文件。每个疑似问题先写出失败的测试,确认后再修;这些测试留下来作为回归测试。设计上的变化记在 ADR 0034。

最严重的几个​

  • 被拒绝的恢复已经改了东西。 归档里配置和密钥排在数据库前面,以前遇到数据库条目才检查"目标已有站点",被拒绝时管理员令牌已经换成了归档里的。现在所有检查都在写入之前完成。名为 secrets/.. 的条目会写到数据目录外面,也一并堵上。
  • 保留的密钥可以被送到别处。 管理员不知道 SMTP 密码,但可以只改 SMTP 主机、保留密码,再发一封测试邮件,密码就到了自己的服务器。社交登录的密钥同理(把 issuer 改成自己的)。现在改了密钥的去处就必须重新填写密钥。
  • "需要验证邮箱"管不住启动器。 未验证账号的启动器令牌每次刷新都会拿到新的刷新期限,可以一直用下去,还能通过 Yggdrasil 上传材质。
  • systemd 单元可以被注入指令。 路径或用户名里的换行会原样写进由 root 运行的单元。
  • 部署冒烟测试里有一个注定失败的任务。 package.sh 在 git 里没有可执行权限;还有两处 CI 检查无论如何都不会失败(bash 的 ! cmd 不触发 set -e)。
  • split 模式上传较大的材质会失败。 后端是只读根文件系统,multipart 的临时文件写不进 /tmp。

其它​

  • 一个带未闭合引号的主题变量会吞掉后面所有变量和整个暗色模式;前后端改用同一套检查。
  • 翻译覆盖改用 ICU 解析器校验,以前只数花括号:格式错误的文字会让页面显示键名,合法的复数写法反而被拒。
  • MySQL 上两个管理员同时第一次保存带密钥的设置会死锁。设置保存改为先锁配置版本行,保存一个接一个地进行。
  • 系统状态会拿迁移锁:另一个节点正在迁移时,状态页会卡住最多 5 分钟。
  • 积分比率没有上限,乘以上传的 KB 数会溢出,"花费"变成进账。
  • 首页区块随每个页面发给浏览器;最坏情况下每页多 500 KB。
  • CDN 配置填到一半时,每个玩家事件都会失败并重试约 80 分钟。
  • 在站点旁边执行 CLI 命令会轮换服务器正在写的日志文件。
  • 文档里 Kubernetes 的命令先建 Secret 后建命名空间;升级发行包后忘了把目录交还给服务用户。

验证​

  • go fmt、go vet(Windows、Linux、macOS);完整的 go test ./...,SQLite 与 PostgreSQL(英文和中文错误信息各一遍);设置的并发测试在 PostgreSQL 上重复 10 次。
  • 前端类型检查与 80 个单元测试;bun install --frozen-lockfile 确认 lockfile 一致。

中文 PostgreSQL 上的 500​

验证时还发现一个 M4 之前就有的问题。第一次跑 PostgreSQL 测试时,新建的测试数据库用了系统的中文区域设置,账号、角色、举报、材质的十几个测试都失败了:邮箱已被使用、角色名已被占用,返回的不是对应的提示而是 500。

原因是 ent 的 IsConstraintError 靠匹配英文错误信息("violates unique constraint")识别冲突,而 PostgreSQL 用服务器的语言写错误信息。装在中文系统上的 PostgreSQL 默认就是中文,这在国内并不少见。

改为按 SQLSTATE 错误码识别(db.IsConstraint),错误码不随语言变化。所有调用方都改用它,并加了一个测试,禁止再直接使用 ent.IsConstraintError。之后在一个报错为中文的 PostgreSQL 上跑完整测试,全部通过。

仍未验证​

  • MySQL 只在 CI 里跑,设置保存的死锁修复要等 CI 结果。
  • Compose、Helm、systemd 的部署冒烟测试要推送后在 CI 里跑。

下期计划​

进入 M5:BS 导入器、契约测试全量、k6 压测、安全自查和真实站点 beta。