第 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。