分类： AI 工具排错

在 vLLM 对称 P2P KV offload 模式下，若同一 kv_request_id 经历多次 lookup→fetch 轮次，consumer 可能因 producer 端状态被意外清空而等待 30 秒超时。优先排查是否是 _OutboundRequestState 在轮次间被 _fina

该报错通常出现在 Open WebUI 连接本地 HTTP 的 llama 服务时，错误信息中的 ssl:default 是 aiohttp 库的固定输出格式，实际原因是 DNS 查询超时。优先排查容器间网络连通性及 DNS 解析。

该报错发生在 RAGFlow 中已添加一个 vLLM 聊天模型后，尝试添加另一个 vLLM 模型（如 reranker）到不同 host:port 时。优先检查是否因 TenantModelInstance 表的数据库唯一约束导致，通常的解决方法是升级到 v0.26.0 之后的修复版本。

当 RAGFlow 配置了 OIDC 认证且设置 REGISTER_ENABLED=0 时，新用户仍能通过 OIDC 自动注册。优先检查 OAuth/OIDC 回调处理程序是否对 REGISTER_ENABLED 进行了判断。