使用LangChain创建的Qdrant集合中向量为null的原因排查

云原生阿岚

2026-7-4

问题

使用LangChain V0.0.335执行以下代码创建Qdrant集合：

from langchain.vectorstores import Qdrant
...
qdrant= Qdrant.from_documents(
    documents = docs,
    embedding = embeddings,
    collection_name = "book_1"
)

通过Qdrant UI查询得到如下结果：

{
  "result": {
    "points": [
      {
        "id": "003af5c5-4a3e-4d80-a257-46bda8628908",
        "payload": {
          "metadata": {
            "source": "./simple_qdrant/Mr_Spaceship.txt",
            "start_index": 8875
          },
          "page_content": "\"I don't like the idea,\" Kramer said. In his mind an image had appeared, the image of an old man sitting behind a desk, his bright gentle eyes moving about the classroom. The old man leaning forward, a thin hand raised—\n\n\"Keep him out of this,\" Kramer said.\n\n\"What's wrong?\" Gross looked at him curiously.\n\n\"It's because I suggested it,\" Dolores said."
        },
        "vector": null
      }
    ],
    "next_page_offset": "05dd3eb3-6ee3-4d42-be86-7c387c35dc16"
  },
  "status": "ok",
  "time": 0.001733464
}

预期vector应为数值列表（如[0.1,0.2,...]），但实际为null。发现/langchain/vectorstores/qdrant.py中没有from_documents方法，该方法定义在/langchain/schema/vectorstore.py中，请问这是否是导致向量为null的原因？

回答

from_documents方法继承是正常设计，不是问题根源
Qdrant类继承自LangChain的VectorStore基类，from_documents是基类提供的通用批量导入方法，所有向量存储实现类都会复用这个逻辑，这是标准设计模式，和向量为null无关。
向量显示为null的常见原因及解决方式
1. Qdrant UI默认不返回向量：Qdrant Web UI查询时默认隐藏向量数据，只需在查询界面勾选「Include vectors」选项，或通过API查询时添加with_vectors=true参数，即可查看实际存储的向量数值。
2. 嵌入模型未正常生成向量：验证embeddings实例是否有效，调用embeddings.embed_query("test")检查是否能输出正常的数值向量。如果嵌入模型调用失败，会导致无向量写入Qdrant。
3. 版本兼容性问题：LangChain V0.0.335属于旧版本，可能存在Qdrant集成的bug。建议升级到稳定新版本，并确保qdrant-client版本与LangChain版本匹配。
4. 集合向量配置不匹配：检查Qdrant集合的向量维度是否与嵌入模型输出的维度一致。若创建集合时未指定正确维度，Qdrant无法正常存储向量。

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