标签： LLM

这个报错通常发生在通过 RAGFlow API 或服务层创建会话（Conversation）时，未从登录用户会话或请求上下文中正确提取 user_id，导致数据库记录中该字段为空。优先检查会话创建和更新的代码路径，确保 user_id 被显式传入。

这个报错通常发生在 RAGFlow 通过 Docker Compose 启动时，MySQL 容器因数据目录初始化不完整或已有损坏数据导致健康检查失败。优先检查并清理 ./volumes/mysql_data 目录后重启服务。

这个报错通常发生在 llama.cpp 使用模型默认的最大上下文（context）窗口初始化 KV Cache 时，因上下文设置过大导致需要分配数百 GB 内存。优先排查并把上下文长度手动设置为你实际需要的小数值。

该报错通常发生在 Dify 自托管环境使用第三方 vLLM 模型插件调用 Qwen 系列模型时，Dify Agent V2 运行时将系统消息插入到消息数组的非首位，Qwen 聊天模板严格拒绝并返回 400 错误。优先排查方式：确认使用的模型插件是否为第三方 vLLM 插件，尝试切换为内置 OpenA

该报错最常见于使用非官方打包（如 MSYS2/clang64）的 Ollama 时加载 Qwen3.5 模型，导致 llama.cpp 无法识别 Ollama 导出 GGUF 中的兼容字段而终止。优先排查是否使用了官方发布版本，并确认 GPU 后端（Vulkan）初始化是否成功。

该报错发生在通过 API 创建数据集（Dataset/Knowledge Base）后，在 WebUI 中查看该数据集配置时，解析器（Parser）和分块方法显示为空或始终为“naive”，无法确认 DeepDoc 是否被使用。优先排查后端数据库中 parser_id 字段是否被固定写为 "naiv