LibreChat：运营共享 AI 界面，而不只是聊天页面
阅读 LibreChat 就绪检查：正确解释启动时的 503
沿 serverReady、/readyz 和 rejectChatStartsUntilReady 分析入口分支，区分启动问题与模型认证问题。
你将学会
- 就绪检查的明确分支
- 健康接口回答不同问题
- 把分支变成验收计划
开始前需要
- 基本命令行与配置阅读能力
- 能够在独立且获准的环境中试验
设计只读监控，区分进程可达、应用就绪与模型对话成功，并为缺失样本保留未知状态。
先看结论
- 未就绪的新代理 POST 返回明确错误码。
- abort 和非 POST 放行此项检查。
- 存活成功不能证明就绪。
就绪检查的明确分支
rejectChatStartsUntilReady 在服务已就绪、方法不是 POST，或路径为 /abort 时放行；否则返回 503、值为一秒的 Retry-After，以及 SERVER_NOT_READY 错误码。
该中间件挂载在 /api/agents/chat，结论仅适用于这组路由，不能推广成所有写接口使用同样检查。日程写入在入口中构建了另一套就绪检查。
健康接口回答不同问题
审阅的 /health 和 /livez 在可访问时直接返回 200，而 /readyz 在 serverReady 为 false 时返回 503 和 NOT_READY。只监控 /health 会漏掉监听后初始化未完成的状态。
监听回调在初始化成功后设置 true，错误分支设置 false 并记录初始化失败。无限重试对话或更换供应商密钥之前，应先看这里的错误，确定失败发生在哪一层。
把分支变成验收计划
最小测试应覆盖已就绪 POST、未就绪 POST、未就绪非 POST，以及 abort 例外；分别检查状态、正文和 Retry-After。路由挂载和启动状态迁移再用集成测试验证。
本次检查了分支，但没有运行上游服务或中间件测试。下方决策表是拟议测试夹具，不是通过报告，也不能据此声称整个应用具有某种可靠性水平。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
连同路由挂载阅读就绪检查。
- 2
在受控启动中对比 /livez 和 /readyz。
- 3
分别验证分支与完整初始化。
可复制示例
ready=true → next
ready=false, method!=POST → next
ready=false, path=/abort → next
其余 → 503 + Retry-After: 1 + SERVER_NOT_READY常见问题
每个 503 都要换供应商密钥吗？
不需要，SERVER_NOT_READY 应先检查应用初始化。
这项检查覆盖全部路由吗？
已检查挂载是代理聊天路由，其他路由需单独分析。
资料来源
- LibreChat / api/server/index.js来源核查 2026-09-18