ValueError: not find model file path /ragflow/rag/res/deepdoc/det.onnx
这个报错发生在 RAGFlow 首次启动时 OCR 模块初始化阶段，核心原因是系统在 /ragflow/rag/res/deepdoc/ 目录下找不到 det.onnx 等内置 ONNX 模型文件。优先检查模型文件是否完整，以及启动时能否正常从 HuggingFace 下载缺失的模型。
分类： AI 工具排错
[Question]: Unable to import PDF files
![[Question]: Unable to import PDF files](https://www.chat-gpts.plus/wp-content/uploads/2026/08/9586-3414b67a-768x403.jpg)
该报错通常发生在 RAGFlow Docker 版 20.2 部署后首次创建知识库时，表现为 PDF 文件无法导入、知识库创建后无法打开。优先检查 Docker 容器日志与知识库服务状态，并尝试在浏览器中缩小页面比例以解决模型选择列表无法滚动的问题。
AttributeError: ‘function’ object has no attribute ‘__wrapped__’
该报错是 Dify 测试代码在 Windows 上因路径分隔符不兼容导致的遍历装饰器链失败，优先检查测试文件中的 co_filename.endswith() 比较是否被反斜杠路径干扰。
bare except in storage exists() swallows KeyboardInterrupt/SystemExit
这个报错发生在 Dify 使用 AWS S3 或 Oracle OCI 作为存储后端时， exists() 方法中的裸 except: 会吞掉 KeyboardInterrupt / SystemExit ，导致进程无法正常退出。优先排查存储后端代码中是否存在过宽的异常捕获。
issue: bug: OAuth 2.1 Dynamic/Static Client Registration generates HTTP redirect_uri instead of HTTPS when behind reverse proxy
Open WebUI 在反向代理后调用 OAuth 2.1 动态/静态客户端注册时，redirect_uri 被生成为容器内部地址的 http:// 链接，导致远程 OAuth 服务器以 400 拒绝。优先检查管理后台“WebUI URL”是否已设置为公网 HTTPS 地址，并确认是否曾以持久化配置
feat: Tool-generated files as native in-chat download attachments (click = download) — with working solution
此问题发生在 Open WebUI 工作区 Tool 生成文件（PDF/DOCX/XLSX 等）后，聊天界面没有显示可点击下载的原生附件，或附件点击后只打开预览/无响应。优先排查文件是否已通过 Tool 注册到 Files 面板，以及浏览器端是否存在 JWT 认证导致的 401 下载失败。
issue: Title generation occurs before first message has been processed.
该报错发生在 Open WebUI v0.11.0 中，自动标题生成请求抢先于主聊天请求执行，导致标题仅基于用户首条消息生成而缺少 LLM 回复内容。优先排查 v0.11.0 中标题生成触发时机的时序变化，并关注并行请求的竞态条件。
qwen3.8:27b thows “500 system message must be at the beginning“ Error
该报错发生在 Ollama 将非 SYSTEM 角色的消息放置在 SYSTEM 消息之前时，常见于使用 Claude Code 调用 qwen3.8:27b 模型。优先确认 Ollama 版本是否为 0.32.14 及以上（该版本已合并修复 PR）。
ollama pull ignores folder settings, environment variables, etc.
报错核心是 ollama pull 忽略文件夹设置、环境变量等，模型仍下载到 C 盘。请优先排查 Windows 系统级环境变量 OLLAMA_MODELS 是否在 Ollama 服务启动前已正确配置；如果通过 GUI 修改设置，必须完全退出并重启 Ollama 服务端进程。
[BUG]: Internal Error on ‘upload/{folderName}’ API call
![[BUG]: Internal Error on 'upload/{folderName}' API call](https://www.chat-gpts.plus/wp-content/uploads/2026/08/6106-373e52cd-768x403.jpg)
该报错发生在通过 AnythingLLM Desktop 的 API 接口 /v1/document/upload/{folderName} 批量上传文件时，返回 500 错误但文件实际已上传到默认的 custom-documents 目录。此问题已在 PR #6027 中修复，升级到 Anythi