Lightrag 文档处理不成功（httpx.ReadTimeout 为主）的解决步骤与方法总结

当 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 服务：
  1. 重启 Ollama：关闭所有 Ollama 窗口，重新执行 ollama serve（确保命令行显示 Listening on 127.0.0.1:11434）；
  2. 检查端口占用：执行 netstat -ano | findstr "11434"，若有其他进程占用，结束该进程或修改 Ollama 端口（需同步更新 Lightrag 配置）