From 12f3fc4ac5b24b6a106b8c40cb57db4d0d47d565 Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 12 Sep 2026 11:48:32 +0800 Subject: [PATCH] =?UTF-8?q?fix(state):=20=E5=85=B1=E4=BA=AB=E5=86=85?= =?UTF-8?q?=E5=AD=98=E5=86=99=E5=A4=B1=E8=B4=A5=E5=BF=85=E9=A1=BB=E5=87=BA?= =?UTF-8?q?=E5=A3=B0=EF=BC=8C=E9=81=BF=E5=85=8D=E3=80=8C=E6=96=B0=E5=BB=BA?= =?UTF-8?q?=20Key=20/=20=E5=9F=9F=E5=90=8D=20/=20=E4=B8=8A=E6=B8=B8?= =?UTF-8?q?=E3=80=8D=E9=9D=99=E9=BB=98=E4=B8=8D=E7=94=9F=E6=95=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 背景:热路径(LLM 鉴权查 ukey:、转发查 sub:、上游查 up:)**只读共享内存、无回源兜底**, 所以写穿失败 = 功能立刻不可用。而三处 sync_shm 都把 state::put_* 的 bool 返回值丢掉了: - users::sync_shm → put_ukey 失败 = 该 Key 调 LLM 直接 401 - domains::sync_shm → put_backend 失败 = 该域名直接 404 - upstreams::sync_shm → put_upstream 失败 = 该上游直接 404 表现为「新建/改完就是不生效,日志里什么都没有」——最难查的一类形态。 改动(仅加日志,不改控制流): - 三处 sync_shm 在 state::put_* 返回 false 时 log_err,带上对象标识与后果 - 三处 reload_shm 增加「期望条数 vs 实际装载」核对,不全时汇总报 error (domains 只把 forwardable 计入期望,不可转发的条目不装载不算失败) - users::reload_shm 顺带把 read_users() 取一次复用,避免读两遍 回归:bash tests/run.sh all → 网关 78 / LLM 77 = 155 条,失败 0。 --- rust/src/domains.rs | 17 ++++++++++++++++- rust/src/upstreams.rs | 15 ++++++++++++++- rust/src/users.rs | 24 ++++++++++++++++++++++-- 3 files changed, 52 insertions(+), 4 deletions(-) diff --git a/rust/src/domains.rs b/rust/src/domains.rs index 59f8306..5d2f98b 100644 --- a/rust/src/domains.rs +++ b/rust/src/domains.rs @@ -91,12 +91,20 @@ pub fn validate_type(raw: Option<&String>) -> String { // =========================================================================== /// 把一条记录同步进共享内存。**所有写操作之后必须调用它**。 +/// +/// 写失败 = 热路径查不到 = 该域名立刻 404,所以失败必须出声 +/// (`state::put_backend` 返回 false:共享内存 zone 满或分配失败)。 pub fn sync_shm(entry: &DomainEntry) { let now = util::now(); if entry.is_forwardable(now) { // long 用 0 表示永不过期;temp 用真实到期时刻,热路径读到即知是否还能用 let exp = if entry.dtype == "temp" { entry.expires_at } else { 0 }; - state::put_backend(entry.subdomain.as_bytes(), entry.backend.as_bytes(), exp); + if !state::put_backend(entry.subdomain.as_bytes(), entry.backend.as_bytes(), exp) { + util::log_err(&format!( + "[domains] 转发映射写共享内存失败 sub={} —— 该域名会 404(共享内存可能已满)", + entry.subdomain + )); + } } else { state::invalidate(entry.subdomain.as_bytes()); } @@ -108,15 +116,22 @@ pub fn sync_shm(entry: &DomainEntry) { pub fn reload_shm() -> usize { state::clear_prefix(KEY_SUB_PREFIX); let now = util::now(); + let mut expected = 0; let mut loaded = 0; for entry in store::read_domains() { if entry.is_forwardable(now) { + expected += 1; let exp = if entry.dtype == "temp" { entry.expires_at } else { 0 }; if state::put_backend(entry.subdomain.as_bytes(), entry.backend.as_bytes(), exp) { loaded += 1; } } } + if loaded != expected { + util::log_err(&format!( + "[domains] 转发映射装载不全:{loaded}/{expected} —— 有域名会 404" + )); + } loaded } diff --git a/rust/src/upstreams.rs b/rust/src/upstreams.rs index ad90a65..eaedae3 100644 --- a/rust/src/upstreams.rs +++ b/rust/src/upstreams.rs @@ -123,7 +123,11 @@ pub fn validate_base(raw: &str) -> Result { /// 「查不到 = 不可用」,这样停用即刻生效,且不留残留条目。 pub fn sync_shm(slot: &str, up: &Upstream) { if up.enabled { - state::put_upstream(slot, &payload_of(up)); + if !state::put_upstream(slot, &payload_of(up)) { + util::log_err(&format!( + "[upstreams] 上游配置写共享内存失败 slot={slot} —— 该上游会 404(共享内存可能已满)" + )); + } } else { state::remove_upstream(slot); } @@ -138,12 +142,21 @@ fn payload_of(up: &Upstream) -> String { /// 只清 `up:` 前缀,不会误伤转发映射与管理会话。 pub fn reload_shm() -> usize { state::clear_prefix(KEY_UP_PREFIX); + let mut expected = 0; let mut loaded = 0; for (slot, up) in store::read_upstreams() { + if up.enabled { + expected += 1; + } if up.enabled && state::put_upstream(&slot, &payload_of(&up)) { loaded += 1; } } + if loaded != expected { + util::log_err(&format!( + "[upstreams] 上游装载不全:{loaded}/{expected} —— 有上游会 404" + )); + } loaded } diff --git a/rust/src/users.rs b/rust/src/users.rs index 5ea18a3..2f249f6 100644 --- a/rust/src/users.rs +++ b/rust/src/users.rs @@ -70,21 +70,41 @@ fn identity_payload(user: &User) -> String { } /// 把账号的 Key 索引写进共享内存。**所有改动 `api_key` 的写操作都必须调用**。 +/// +/// 写失败(共享内存 zone 满 / 分配失败)会让这个 Key **静默失效**:热路径查不到 +/// 就是 401,且没有任何回源兜底。所以这里必须自己出声——「新建了 Key 却调不通、 +/// 日志里什么都没有」是这类问题最难查的形态。调用方是否检查返回值不影响本日志。 pub fn sync_shm(user: &User) -> bool { - state::put_ukey(&user.api_key, &identity_payload(user)) + let ok = state::put_ukey(&user.api_key, &identity_payload(user)); + if !ok { + util::log_err(&format!( + "[users] Key 索引写共享内存失败 user={} —— 该 Key 调 LLM 会 401(共享内存可能已满)", + user.username + )); + } + ok } /// 全量重载 Key 索引(启动装载 / 批量变更后)。返回装载条数。 /// /// 只清 `ukey:` 前缀,不会误伤转发映射、上游表与管理会话。 +/// `loaded < total` 时单独报一条 error:单个账号的失败已在 `sync_shm` 里出声, +/// 这里再汇总一次,避免「装载了 3/5 却只在滚动日志里淹没」。 pub fn reload_shm() -> usize { state::clear_prefix(KEY_UKEY_PREFIX); + let table = store::read_users(); + let total = table.len(); let mut loaded = 0; - for user in store::read_users().into_values() { + for user in table.into_values() { if sync_shm(&user) { loaded += 1; } } + if loaded != total { + util::log_err(&format!( + "[users] Key 索引装载不全:{loaded}/{total} —— 有账号将无法调用 LLM" + )); + } loaded }