当 Lightrag 处理文档（如纯文本、Excel）失败并提示httpx.ReadTimeout时，核心原因是Lightrag（Docker 容器内）与 Ollama 服务通信超时，需按「基础依赖→网络连通→配置生效→文件优化→底层兜底」的逻辑分步排查，具体步骤如下：一、优先排查基础依赖：Ollama 服务是否正常运行Lightrag 依赖 Ollama 提供大模型能力，若 Ollama 自身故障，文档处理必然失败，需先验证 Ollama 可用性：1. 测试主机上的 Ollama 服务是否存活在Windows 主机（非 Docker 容器）打开 PowerShell，执行以下命令（Ollama 默认端口11434）：# 调用 Ollama API 查看已下载的模型列表（验证服务存活） curl http://localhost:11434/api/tags正常响应：返回 JSON 格式的模型列表（如tinyllama、llama3），说明 Ollama 服务正常；异常响应（如 “无法连接”“超时”）：先修复 Ollama 服务：重启 Ollama：关闭所有 Ollama 窗口，重新执行
Lightrag 文档处理不成功（httpx.ReadTimeout 为主）的解决步骤与方法总结
发布时间：2026/6/8 11:40:02
当 Lightrag 处理文档（如纯文本、Excel）失败并提示httpx.ReadTimeout时，核心原因是Lightrag（Docker 容器内）与 Ollama 服务通信超时，需按「基础依赖→网络连通→配置生效→文件优化→底层兜底」的逻辑分步排查，具体步骤如下：一、优先排查基础依赖：Ollama 服务是否正常运行Lightrag 依赖 Ollama 提供大模型能力，若 Ollama 自身故障，文档处理必然失败，需先验证 Ollama 可用性：1. 测试主机上的 Ollama 服务是否存活在Windows 主机（非 Docker 容器）打开 PowerShell，执行以下命令（Ollama 默认端口11434）：# 调用 Ollama API 查看已下载的模型列表（验证服务存活） curl http://localhost:11434/api/tags正常响应：返回 JSON 格式的模型列表（如tinyllama、llama3），说明 Ollama 服务正常；异常响应（如 “无法连接”“超时”）：先修复 Ollama 服务：重启 Ollama：关闭所有 Ollama 窗口，重新执行
