标签： Python

该报错发生在 LlamaIndex 的 MetadataReplacementPostProcessor 节点后处理器中，当节点 metadata 里目标 key 存在但值为 None 时触发。优先排查你的 metadata 中是否有字段被显式设置为 None （例如从 JSON 往返加载、向量存储

该报错发生在 LlamaIndex 搭配 WeaviateVectorStore 且使用独立 IndexStore（如 PostgreSQL）重建索引后执行查询时。优先排查 Weaviate 查询过滤器中的属性路径是否使用了不存在的 "id" 字段，应改为 schema 中实际存储节点 ID 的属性

该性能下降问题发生在 llama.cpp 的 llama-server 使用带大量工具触发的模型（如 Qwen3.8-27B）进行长文本生成时，原因是“lazy grammar”实现了 O(n²) 复杂度的触发器搜索。优先检查你的工具调用模板是否会为每个工具生成独立的 WORD 触发器，以及是否运行

该报错发生在 RAGFlow 使用 Infinity 作为向量数据库时，查看已解析文档的 Chunk 触发检索接口，Infinity 返回“Fail to bind the expression: tag_feas”错误（Error Code 3013）。优先排查 RAGFlow 与 Infinit

当 LlamaIndex 配合 DeepSeek 模型使用 OpenAILike 时，会因默认调用已废弃的 /v1/completions 文本补全端点而返回 400 Bad Request。优先排查是否显式设置了 is_chat_model=True ，并确认 model 与 api_base 参