知识条目 / Milvus

Milvus 报 collection not loaded 或查询超时如何排查?

先确认集合加载状态与 querynode 资源,再检查 etcd/MinIO 依赖与索引构建状态。

Milvus 查询前需要将集合加载到 querynode 内存。加载失败或超时通常与资源不足、索引未就绪、对象存储或 etcd 异常有关。

处理步骤

  1. 确认加载状态查看 collection 的 load state 与 index 状态,确认是否处于 Loaded 或构建中。
  2. 检查组件健康确认 etcd、MinIO、querynode 与 proxy 的运行状态及错误日志。
  3. 评估资源检查 querynode 内存与副本数是否能容纳集合规模,避免加载时 OOM。
  4. 重试与治理修复依赖后重新 load,必要时扩容 querynode 或降低单次加载集合规模。

示例

from pymilvus import Collection
c = Collection("demo")
c.load()
print(c.num_entities)

# 查看索引与加载进度
print(c.indexes)

不同 Milvus 版本的加载接口与指标名称不同,请以所部署版本文档为准。

关键词

milvus · collection not loaded · 加载 · querynode · 索引 · etcd · minio

官方文档

同库知识