Skip to content

fix(storage): validate KV proxy health response - #79

Open
wumingzhinu wants to merge 2 commits into
OpenListTeam:mainfrom
wumingzhinu:fix/healthz-env-check
Open

wumingzhinu wants to merge 2 commits into
OpenListTeam:mainfrom
wumingzhinu:fix/healthz-env-check

Conversation

@wumingzhinu

Copy link
Copy Markdown
Contributor

Summary / 摘要

  • 修复 KV 代理健康探测:只有返回合法 { keys: [] } JSON 的 HTTP 200 才视为可用,避免 SPA HTML 200 让 serverless env_check 错误报告 ready=true。

  • 保留 401 的既有语义:驱动可选中以显示诊断信息,但 health 仍报告不可用。

  • 增加合法 JSON、HTML 200、错误结构和 401 的回归测试。

  • 同步重建 cloud-functions/[[default]].js。

  • This PR has breaking changes.
    / 此 PR 包含破坏性变更。

  • This PR changes public API, config, storage format, or migration behavior.
    / 此 PR 修改了公开 API、配置、存储格式或迁移行为。

  • This PR requires corresponding changes in related repositories.
    / 此 PR 需要关联仓库同步修改。

Related repository PRs / 关联仓库 PR:

  • OpenList: none
  • OpenList-Docs: none

Testing / 测试

  • node node_modules/tsx/dist/cli.mjs --test src/backend/server/healthz.test.ts — 6/6 passed
  • node node_modules/tsx/dist/cli.mjs --test src/backend/server/kv_proxy_loop.test.ts — 6/6 passed
  • git diff --check
  • Full typecheck — 2 pre-existing errors in src/backend/internal/model/db_cipher.test.ts:187-188
  • Full server suite on this branch — remaining failures are from PR test(auth): isolate default credential cases #77/fix(seed): preserve CAS cloud metadata #78 test baselines not yet merged into main

Checklist / 检查清单

  • I have read CONTRIBUTING.
    / 我已阅读贡献指南。
  • I confirm this contribution follows the repository license, contribution policy, and code of conduct.
    / 我确认本次贡献符合仓库许可证、贡献规范和行为准则。
  • I have formatted the changed code with Prettier where applicable.
    / 触及的源文件基线存在既有格式差异,本次未进行无关全文件重排。
  • I have requested review from relevant maintainers or code owners where applicable.
    / 我已在适用情况下请求相关维护者审查。

AI Disclosure / AI 使用声明

  • This PR includes AI-assisted content.
    / 此 PR 包含 AI 辅助内容。

Tools used / 使用工具:

  • Other: OpenCode

Usage scope / 使用范围:

  • Code generation / 代码生成

  • Tests / 测试

  • Review assistance / 审查辅助

  • I have reviewed and validated all AI-assisted content included in this PR.
    / 我已审核并验证此 PR 中的所有 AI 辅助内容。

  • I have ensured that all AI-assisted commits include Co-Authored-By attribution.
    / 我已确保所有 AI 辅助提交都包含 Co-Authored-By 归属信息。

  • I can reproduce all AI-assisted content included in this PR without any AI tools.
    / 我可以在没有 AI 工具的情况下重现此 PR 的内容。

@pikachuren

Copy link
Copy Markdown
Collaborator

评审结论:可以合并

这个修复方向正确:SPA 壳在 200 下返回 HTML 会让 env_check 误报 ready=true。

唯一需要确认的前提我已核对通过:新的判定要求 200 且 Array.isArray(payload.keys),而真实的
functions/kv-list/index.js 返回的正是 json({ keys: [...seen] }) —— 形状匹配,不会误判 KV 不可用。
401 的既有语义(isAvailable() 为真供诊断、health() 报不可用)也保持不变。

小建议

  • 目前只校验 JSON 里 keys 是数组;可考虑同时看 content-type,让失败原因更明确。
  • 若代理返回还带分页字段(list_complete / cursor),当前实现是兼容的(只要求 keys 是数组),这点没问题。

与 #89 的关系(建议协调)

根因有两层:(a) 不该探测(#89 在治:auto 模式下没有可靠平台标记就不探测);
(b) 探测到 200 就当成可用(本 PR 在治)。两者互补而非重复,建议都保留。
注意 #89 也改 kv.ts 同一文件,需协调 rebase 顺序;另外 #89 目前把门控只加在 isAvailable()
而漏了 health()(详见该 PR 的评审)。


本评论由 AI 辅助的自动化评审生成,基于对该 PR 当前 head 提交的源码核对。标注「实测复现」的结论已在本地用真实源码(打补丁后)跑脚本验证;其余为代码走查结论。请以人工复核为准。

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants