fix(state): 共享内存写失败必须出声,避免「新建 Key / 域名 / 上游」静默不生效

背景:热路径(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。
This commit is contained in:
admin committed 2026-09-12 11:48:32 +08:00
1 parent 13c0c7a427
commit 12f3fc4ac5
3 files changed
+52 -4

No files matched your search

+16 -1
View File
@@ -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
}
+14 -1
View File
@@ -123,7 +123,11 @@ pub fn validate_base(raw: &str) -> Result<String, String> {
/// 「查不到 = 不可用」,这样停用即刻生效,且不留残留条目。
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
}
+22 -2
View File
@@ -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
}