docs(memory): 记录封禁键/取证地址分离的根因、测试与变异验证经验

2026-10-23 10:53:13 +08:00
parent 90a284a3dd
commit 29ddee07db
2 changed files with 47 additions and 0 deletions
@@ -27,3 +27,8 @@
  排查口诀：响应体是这句中文 → 一定是部署侧缺文件，不是代码回退。
  `getFont` 现已支持 candidates（`font_path` → `static/fonts/*` → 系统 CJK 字体）且不缓存失败，
  补文件后无需重启。
+- ⚠️ **`GOSUMDB=off` 会让 toolchain 自动下载失败**：go.mod 要 1.27.3 而 PATH 上的 `go` 是旧版时，
+  会报 `golang.org/toolchain@...: verifying module: checksum database disabled by GOSUMDB=off`
+  （`go version` 显示的还是 shell 包装器的版本，容易误判成「版本没变」）。
+  解法：直接用缓存里的 toolchain 并禁用自动切换——
+  `PATH="$HOME/go/pkg/mod/golang.org/[email protected]/bin:$PATH" GOTOOLCHAIN=local go test ./...`