docs(CLAUDE): 硬规矩补「写共享内存失败必须出声」
This commit is contained in:
1 parent
12f3fc4ac5
commit
d870168ca3
1 file changed
+3
@@ -325,6 +325,9 @@ carol `llm_rpm=2`、dave `llm_daily=2`(限流断言用)。夹具上游含 **
|
||||
③ 涉及域名/Key/上游变更的,**必须调对应的 `sync_shm`**——漏了就等于没生效(无回源兜底)。
|
||||
鉴权由分发器统一兜底,**不要在单个 handler 里重复实现**。
|
||||
- **所有写操作必须同时更新 shm 与 JSON 文件**。只写一边会出现「重启后配置回滚」或「改了不生效」。
|
||||
- **写共享内存失败必须出声**。`state::put_*` 返回 `false`(zone 满 / 分配失败)时,三处 `sync_shm`
|
||||
会 `log_err`(带对象标识与后果),三处 `reload_shm` 会核对「期望条数 vs 实际装载」。**别丢掉返回值**——
|
||||
热路径没有回源兜底,写失败就是「刚建好却调不通,日志里什么都没有」,属于最难查的一类形态。
|
||||
- **`env ADMIN_INIT_PASSWORD;` 必须在 `conf/nginx.conf` 的 main 上下文**。少了这行 nginx 会剥离环境变量,
|
||||
模块读到的初始密码恒为空(靠 `INIT_ADMIN_PASSWORD` 播种 admin 的逻辑就依赖它)。
|
||||
- **新增 location 用 `$proxy_backend_addr` 时**,变量注册已在 `lib.rs` 的 **preconfiguration** 完成;
|
||||
|
||||
Reference in new issue
Block a user