分类： AI 工具排错

AI 工具排错

[Question]: [MinerU] Output directory

该报错通常发生在 RAGFlow 使用 MinerU 解析 PDF 时，输出文件路径不一致导致 MinerU 找不到生成的 _content_list.json 。优先排查 RAGFlow 版本是否低于 2025‑12‑01（未包含 PR #11623 的修复）。核心报错： [MinerU] Mis

celebrityanime
2026年 7月 29日

AI 工具排错

[Question]:

Docker 部署 RAGFlow 后 Web 界面完全无法使用（创建知识库、上传文件、接入模型、刷新页面均失效），通常由后端服务故障（MySQL、MinIO、Elasticsearch、Redis）或配置错误引起。优先检查 docker ps 确保所有容器正常运行，并查看容器日志。

celebrityanime
2026年 7月 29日

AI 工具排错

[Question]: Mineru Chunking

当 RAGFlow 使用 Mineru 作为 OCR 文档解析器时，Chunk size 和 Image & table context window 等配置参数被完全忽略，生成大量极小的分块（每句话一个块，表格单独分块）。优先排查是否启用了其他覆盖配置，但本质上这是 Mineru 分块逻辑的已知限

celebrityanime
2026年 7月 29日

AI 工具排错

Style leakage in gr.Chatbot when rendering HTML code snippet

当 gr.Chatbot 的 content 字段包含带标签的 HTML 代码片断时，该样式会泄漏到整个 Gradio 应用页面，导致 Style leakage in gr.Chatbot when rendering HTML code snippet 。优先排查是否在 Cha

celebrityanime
2026年 7月 29日

AI 工具排错

[Bug]: JWT team auth fails on /v1/messages unless x-litellm-team-id is explicitly set

JWT team auth 在 /v1/messages 端点失败，返回 No team has access to the requested model ，除非显式传递 x-litellm-team-id 。原因是 LiteLLM_JWTAuth.team_allowed_routes 默认列表

celebrityanime
2026年 7月 29日

AI 工具排错

TypeError: Object of type timedelta is not JSON serializable

该报错在 LiteLLM 使用 routing_strategy: latency-based-routing 且配合 Redis/Valkey 缓存时，对非聊天请求（embeddings、speech、image 等）产生，原因是 lowest_latency.py 中 timedelta 到秒的

celebrityanime
2026年 7月 29日

AI 工具排错

[Bug]: /v1/messages adapter drops reasoning_content → thinking blocks for OpenAI-compatible chat-completions backends (streaming)

当 LiteLLM 通过 /v1/messages 代理 OpenAI 兼容后端（如 vLLM、SGLang）并使用流式传输时，模型返回的 reasoning_content （推理链）在转译为 Anthropic 格式的 thinking 块时被静默丢弃。优先排查原始 SSE 流中是否包含 rea

celebrityanime
2026年 7月 29日

AI 工具排错

Misc. bug: Intel UHD 770 graphics crashes on Vulkan TOP_K unit test

Misc. bug: Intel UHD 770 graphics crashes on Vulkan TOP_K unit test 通常发生在集成显卡（2 Xe 核心）运行 llama.cpp 的 Vulkan 后端 TOP_K 单元测试（k=1023 最坏情况）时，因执行时间过长触发 Wind

celebrityanime
2026年 7月 29日

AI 工具排错

ValueError: Invalid JSON for field ‘picture_description_api’: 1 validation error for nullable[PictureDescriptionApi

此报错通常出现在 Open WebUI 的 Docling Parameters 中配置了嵌套 JSON 对象（如 picture_description_api ）时，Open WebUI 的 requests.post(data=...) 会错误地将嵌套对象的每个键拆分成独立的表单字段，导致 D

celebrityanime
2026年 7月 29日

AI 工具排错

issue: idle performance regression caused by timer query in 0.11.0

Open WebUI v0.11.0 在空闲时 CPU 和 RSS 显著升高，原因是新增的定时器轮询对 chat 表执行未加索引的 JSON_EXTRACT 全表扫描。优先排查是否开启了 Timer 功能，并考虑回退到 v0.10.2 或等待官方修复。

celebrityanime
2026年 7月 29日