LibreChat 常见报错处理

endpoint 不显示

检查 librechat.yaml 是否挂载到容器中，并确认 YAML 缩进正确。

处理方式：

docker compose logs -f

查看启动日志中是否有配置解析错误。

API Key 没生效

如果使用 ${XIKAPI_API_KEY}，需要确认 .env 中存在：

XIKAPI_API_KEY=YOUR_XIKAPI_API_KEY

修改 .env 后需要重启容器。

404 Not Found

检查 baseURL：

baseURL: "https://xikapi.com/v1"

不要写成 /chat/completions。

模型不显示

如果 fetch: false，模型必须手动写在 models.default 中。

models:
  default:
    - "YOUR_MODEL_ID"

标题生成失败

titleModel 也必须是可用模型。可以先设置为低成本文本模型：

titleModel: "YOUR_MODEL_ID"