Skip to content

[web] 全新安装下 /__bili/overview 与 /__bili/sessions 返回 500:refreshIndex 把 sessions 目录缺失(ENOENT)当致命错误上抛 #2181

Closed

Description

@ranxianglei

来源: #2148 (#2148) PR #2151 (#2151) 的 CI 失败分析时发现

现象(可确定性复现)

在任何 sessions 目录从未被创建过的干净环境(全新安装 / 全新 CI runner)中,/__bili/overview 与 /__bili/sessions 返回 500:

[error] [acp-web] overview failed: Error: ENOENT: no such file or directory, scandir '<HOME>/.local/share/billion-context/sessions'

复现:把 HOME 指向空目录后跑 node --import tsx --test tests/advisory-endpoint-parity.test.ts → 与 CI 完全同错;HOME 已有 sessions 目录 → 通过。CI 证据:master @ 4af31e0 与 PR #2151 @ 77191de 四个 test lane(ubuntu/windows × node22/24)全部挂在同一测试(#2153 的 parity test):/__bili/overview answers 200 → 实际 500。

根因

  • walkSessionFiles(src/web/sessions-data.ts:198)对顶层 readdir 失败有意抛出(doc comment:让调用方区分「无数据」与「不可读」);
  • 但唯一调用方 refreshIndex 的 catch(src/web/sessions-data.ts:317–320)没有做这个区分:if (!byFile) throw error; —— 干净环境的第一次刷新没有旧索引,ENOENT 被原样上抛 → mergedSummaries reject → buildOverview / buildSessionList / buildSessionPage 全 reject → 端点 500;
  • sessions 目录只在首次 persist 时创建(persist.ts),启动时不建 → 全新安装(尚无任何已存会话)必然踩中。

引入自 e0ef92a(#1939 系「bound web admin session loading」);#2153 的 parity test 首次在 fresh runner 上打 /__bili/overview,CI 随即变红。

影响

  1. 全新安装的 web dashboard 在首个会话落盘前,overview/sessions 端点 500(用户看到错误横幅);
  2. CI 四个 test lane 持续红,master 与所有新 PR 都被这个红挡住(与各自 diff 无关)。

修复(PR #2151 内独立 commit)

refreshIndex catch 按 errno 区分:ENOENT → 空索引(byFile/byId 置新 Map,即 doc comment 本意要区分的「无数据」态);其余错误(EACCES 等)保持现状——无旧索引 fail-fast 抛出、有旧索引 warn + 继续服务旧索引。已有目录的正常路径零变化;parity test 在 fresh/既有两种环境都确定性通过。

Activity

  1. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 已修复并验证 — 修复已作为独立 commit 6abecdd7c 落在 PR #2151 分支上(按 issue 指定的方式),CI 全绿。

    过程说明:本会话独立完成了根因复核与修复实现(与 issue 方案一致),推送时发现并行 agent 会话已把等价修复推到了同一分支(6abecdd7c,loop guard:一个 issue 一个 PR,不重复提交)。我改为对已落地的 commit 做完整独立验证,未推重复 commit。两处实现的差异见第 4 条。

    结构化七问:

    1. 是什么问题:全新安装(sessions 目录从未被创建)时,web dashboard 的 /__bili/overview 与 /__bili/sessions 在首个会话落盘前返回 500,用户看到错误横幅。
    2. 什么原因导致的:walkSessionFiles(src/web/sessions-data.ts:198)对顶层 readdir 失败有意抛出,doc comment 明确要求调用方区分「无数据」与「不可读」;但唯一调用方 refreshIndex 的 catch 没有做这个区分——干净环境第一次刷新没有旧索引(byFile === null),ENOENT 被 if (!byFile) throw error 原样上抛,buildOverview/buildSessionList/buildSessionPage 全部 reject → 端点 500。sessions 目录只在首次 persist 时创建、启动时不建,所以全新安装必然踩中。引入自 e0ef92a(fix: bound web admin session loading (paged list, summary index, lazy detail) #1939 系)。
    3. 怎么修复的:refreshIndex catch 按 errno 在决策点分流(不是在上游过滤症状):ENOENT → byFile/byId 置新 Map(即 doc comment 本意的「无数据」态),端点返回空视图;其余错误(EACCES 等)保持原行为。新增确定性回归测试 tests/issue2181-web-missing-sessions-dir.test.ts(目录不存在 → overview/list 解析为空而非 reject,二次调用幂等),并把 管理页面全量加载历史会话时触发堆 OOM:需要有界分页、摘要统计与详情懒加载 #1937 的 breakage 测试重钉到新契约(首触缺失目录:reject → 解析为空,注释中明示行为变更)。
    4. 是否有回归问题:有一处有意的行为变更(issue 方案本身):首触缺失目录从 reject(→500)变为解析空视图。既有行为逐项核对:已有目录的正常路径零变化;EACCES/EPERM 类「不可读」错误保持现状(无旧索引 fail-fast、有旧索引 warn+serve stale,[bug] 0.1.63 起 Windows persist EPERM 风暴:会话持久化静默丢数据(4.9k 次/117 会话)+ compress no-valid-ranges 拒绝 #362 Windows AV 锁场景不受影响);管理页面全量加载历史会话时触发堆 OOM:需要有界分页、摘要统计与详情懒加载 #1937 的「目录中途消失且有旧快照 → serve stale」pin 保持不变。一处语义细节提请 owner 知悉:已落地版本仅在首触(无旧索引)时把 ENOENT 当无数据;若目录曾有数据后整体消失,走的是 管理页面全量加载历史会话时触发堆 OOM:需要有界分页、摘要统计与详情懒加载 #1937 的 warn+stale 路径而不是清空。issue 原文「ENOENT → 空索引」的字面读法覆盖该场景(我本地实现即无条件清空)。两者都自洽,现版本更保守(保留既有 pin);若要无条件清空是一行改动,请拍板。
    5. 是否破坏缓存:不涉及。只动 web 摘要索引的内部 memo Map,请求路径、wire 字节、prefix cache、重试/去重策略零接触。
    6. 是否改了设计方向:不涉及。同模块、同 single-flight 索引设计,只是让调用方兑现了 walkSessionFiles doc comment 早已声明的契约。
    7. 是否引入了新的配置:不涉及。无新 env/config/默认值。

    验证证据(均在本机对新 head 6abecdd7c 执行):

    • 原始 CI 复现:tests/advisory-endpoint-parity.test.ts 在 fresh HOME 下修复前 500、修复后通过;populated HOME 同样通过(两环境确定性绿);
    • 定向套件 fresh HOME:web-sessions(14)+ 新回归测试(1)+ upstream-alerts(8,另一条打 /__bili/overview 的路径)= 22/22;
    • npm run typecheck 干净;
    • CI:6abecdd7c 全部 lane success,包括此前持续红的四个 test lane(ubuntu/windows × node22/24)。

    收工判定:修复完整、CI 全绿,等 PR #2151 人工合并即可(合并后 Fixes #2181 自动关闭本 issue)。

  2. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    和这个重复吗 #2180 另外冲突

  3. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 重复判定:是,#2181 与 #2180 重复(同一 bug、同一根因、同一端点、同一文件 src/web/sessions-data.ts)。差异只在深度与方向:#2180 更早立项(源自 PR #2175 的 CI 红),OP 把它定性为 #1937「never silent empty」契约的细化并给出了你拍板的方案(pristine 门控);#2181 的 OP 则给了更简单的无条件首触 ENOENT→空索引。#2180 已关闭,其修复 PR #2182 已合入 master(merge 4e10ade:ef404a85b pristine→空视图 + 0d30cec07 data root 消失后仍 serve stale 快照)。

    冲突:确认并已解决。 本轮早前(还不知道 #2180/#2182 存在时)我把一个同 bug 的修复 commit 6abecdd7c 推到了 PR #2151 分支上,它和已合入的 #2182 改的是同一批行(refreshIndex catch + #1937 钉死测试),所以 #2151 变成 mergeable_state: dirty。处置:

    一处语义差异需要你知悉(有意保留 master 版本):#2182 合入的方案与 #2181 OP 的字面修法在边界上不同——显式 BILI_SESSIONS_DIR 指向不存在的路径、或 data root 存在但 sessions 子目录缺失时,#2182 维持 loudly reject(500)(你的 sketch:显式覆盖缺失更像 typo,应该响);而 #2181 OP 的简单修法则会返回空。按 #2180「owner decision」的定位,以已合入的 #2182 为准,我这边不再另行调整。

    本 issue 不再产生任何 PR(loop guard 满足:唯一产物就是那个已被摘除的重复 commit)。请帮忙把 #2181 按重复关闭并打 重复 标签指向 #2180——我这套工具只能读 issue 和发评论,没有关闭权限。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    duplicateThis issue or pull request already exists

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions