docs(memory): dev 分享卡 500 的根因（字体从未入库）与二维码模块对齐

2026-10-22 22:33:53 +08:00
parent d51629ef2f
commit a215c2ba2b
2 changed files with 21 additions and 0 deletions
@@ -21,3 +21,9 @@
  正确做法：`grep -ac "中文字符串" 二进制文件`（实测同一个二进制：strings=0、grep -a=1）。
 - ⚠️ 替换二进制后**必须重启进程**：`go build -o X` 只改磁盘文件，正在跑的进程仍是旧映像。
  若服务由 systemd/supervisor 管理，再手动 `./X web` 会因端口被占直接退出。
+- ⚠️ **分享卡字体不在仓库里**：`static/fonts/` 从未入库也没 embed（`static/fs.go` 的清单里没有），
+  `/static/fonts/...` 走 HTTP 是 302 回首页。新环境不手工放字体 → `share-card` 恒 500
+  「字体文件未配置或无法加载」。老环境（如生产）能出图只是因为当年手工补过文件。
+  排查口诀：响应体是这句中文 → 一定是部署侧缺文件，不是代码回退。
+  `getFont` 现已支持 candidates（`font_path` → `static/fonts/*` → 系统 CJK 字体）且不缓存失败，
+  补文件后无需重启。