事故報告:SERVER_ROOT_PATH 回歸導致 UI 路由失效
日期: 2026 年 1 月 22 日 持續時間: 約 4 天(直到修正於 2026 年 1 月 26 日合併) 嚴重性: 高 狀態: 已修復
注意: 此修正自 LiteLLM
v1.81.3.rc.6或更高版本開始可用。
摘要
一個 PR(#19467)意外地從 proxy_server.py 中的 FastAPI 應用程式初始化移除了 root_path=server_root_path 參數。這導致代理程式在提供 UI 時忽略 SERVER_ROOT_PATH 環境變數。當 LiteLLM 部署在具有路徑前綴的反向代理之後(例如 /api/v1 或 /llmproxy)時,使用者發現所有 UI 頁面都回傳 404 Not Found。
- LLM API 請求: 無影響。API 路由未受影響。
- UI 頁面: 使用
SERVER_ROOT_PATH的部署中,所有 UI 頁面都回傳 404。 - Swagger/OpenAPI 文件: 透過設定的根路徑存取時無法運作。

