Llama_index v0.6.35报错：One of nodes or index_struct must be provided 求助

错误本质 #

该错误触发的核心原因是索引初始化时未传入必要的核心数据：要么是已处理的文档节点（nodes），要么是预构建的索引结构（index_struct）。在v0.6.35版本的索引类构造逻辑中，这两个参数必须二选一提供。

常见修复方案 #

1. 确保文档正确转换为Nodes #

如果是从原始文档构建索引，必须完成文档加载→转换为Document对象→生成Node集合的完整流程，示例代码：

from llama_index import SimpleDirectoryReader, GPTVectorStoreIndex, Document

# 加载本地文档
documents = SimpleDirectoryReader("data").load_data()
# 封装为Document对象（可自定义元数据）
docs = [Document(text=d.text, metadata=d.metadata) for d in documents]
# 通过类方法自动生成nodes并构建索引
index = GPTVectorStoreIndex.from_documents(docs)

若需手动生成nodes后初始化索引，必须显式传入参数：

from llama_index import GPTVectorStoreIndex, NodeParser

parser = NodeParser.from_defaults()
nodes = parser.get_nodes_from_documents(docs)
# 显式传入nodes参数初始化索引
index = GPTVectorStoreIndex(nodes=nodes)

2. 修正预构建索引的加载逻辑 #

如果是加载已保存的索引，需确保存储路径正确且索引文件完整，v0.6.35的标准加载方式：

from llama_index import load_index_from_storage, StorageContext

storage_context = StorageContext.from_defaults(persist_dir="./storage")
index = load_index_from_storage(storage_context)

避免手动构建StorageContext后未正确加载index_struct就初始化索引。

3. 排查自定义索引的实现逻辑 #

若你自定义了索引子类，需在构造函数中明确处理nodes或index_struct参数，确保至少有一个被传入并赋值到实例变量，避免遗漏参数校验。

关键排查点 #

• 打印len(documents)或len(nodes)确认文档/节点加载成功，排除空数据导致的参数缺失
• 优先使用from_documents/from_nodes类方法初始化索引，避免直接调用__init__方法遗漏参数
• 锁定依赖版本：v0.6.35与langchain>0.0.240存在兼容风险，可尝试将langchain版本限制在0.0.240及以下

内容的提问来源于stack exchange，提问作者Fran ETH