前言在 Ubuntu 服务器 + Conda 虚拟环境部署 LightRAG 过程中,很多开发者都会遇到一个高频致命问题:正常上传文档、构建向量库、生成知识图谱后,一旦关闭终端、重启服务、重启服务器,再次打开 LightRAG WebUI,所有历史文档全部消失、知识图谱彻底空白。但本地磁盘文件完全没丢:graphml图谱文件、KV 存储、VDB 向量文件、文档状态文件全部完好。排查整整半天最终定位:不是数据损坏、不是缓存丢失,纯粹是 LightRAG 启动未正确指定工作目录导致加载空数据!本文完整复现故障、分析底层原因、给出唯一正确启动方式,彻底根治该问题。一、故障现象LightRAG WebUI 打开后无任何历史上传文档知识图谱面板空白,无实体、无关系、无图形服务器本地数据目录文件齐全,所有知识库、图谱文件完整保留服务启动日志持续输出:KV load full_docs with 0 records KV load full_entities with 0 records Created new empty graph file核心特征: