常见报错
先找到最早出现的错误，再处理后续连带问题。认证和配置错误通常不需要重建索引，查询无结果也不一定要扩大模型上下文。
认证失败、索引中断、查询无结果或费用异常
把 python -m 入口和旧参数换成 3.x CLI
检查 Provider、模型名、端点和环境变量
先用 dry-run 检查，再执行 index 或 update
已有索引需要加入新数据时，使用：
graphrag update更新前保留上一份可以查询的输出，并用几条固定问题比较新旧结果、延迟和费用。
先找到最早出现的错误，再处理后续连带问题。认证和配置错误通常不需要重建索引，查询无结果也不一定要扩大模型上下文。
已有索引需要加入新数据时，使用：
graphrag update更新前保留上一份可以查询的输出，并用几条固定问题比较新旧结果、延迟和费用。
© 2026 GraphRAG 中文社区
独立技术社区，不代表 Microsoft 官方。版本行为以 Microsoft GraphRAG 官方仓库 为准。