Tencent/WeKnora · error

failed to load collection: %w

Error message

failed to load collection: %w

What it means

Milvus collection bootstrap failed at LoadCollection: the collection exists (or was created) but could not be loaded into memory for searching, so the repository aborts before performing writes that assume a queryable collection.

Source

Thrown at internal/application/repository/retriever/milvus/repository.go:199

			createOpt = createOpt.WithShardNum(int32(m.shardsNum))
		}
		err = m.client.CreateCollection(ctx, createOpt)
		if err != nil {
			log.Errorf("[Milvus] Failed to create collection: %v", err)
			return fmt.Errorf("failed to create collection: %w", err)
		}

		log.Infof("[Milvus] Successfully created collection %s", collectionName)
	}

	loadOpt := client.NewLoadCollectionOption(collectionName)
	if m.replicaNumber > 0 {
		loadOpt = loadOpt.WithReplica(m.replicaNumber)
	}
	loadTask, err := m.client.LoadCollection(ctx, loadOpt)
	if err != nil {
		log.Errorf("[Milvus] Failed to load collection: %v", err)
		return fmt.Errorf("failed to load collection: %w", err)
	}
	if err := loadTask.Await(ctx); err != nil {
		log.Errorf("[Milvus] Failed to await load collection: %v", err)
		return fmt.Errorf("failed to await load collection: %w", err)
	}

	// Mark as initialized
	m.initializedCollections.Store(dimension, true)
	return nil
}

func (m *milvusRepository) EngineType() types.RetrieverEngineType {
	return types.MilvusRetrieverEngineType
}

func (m *milvusRepository) Support() []types.RetrieverType {
	return []types.RetrieverType{types.KeywordsRetrieverType, types.VectorRetrieverType}
}

View on GitHub (pinned to 988cbb0330)

Solutions

1. Check Milvus query-node memory and load limits
2. Verify replica/shard configuration
3. Retry the load after cluster resources free up

When it happens

Trigger: Thrown at internal/application/repository/retriever/milvus/repository.go:199 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Tencent/WeKnora@988cbb0330 (2026-09-02). Data as JSON: /api/errors/e6c4731fc9f27ba7. Report an issue: GitHub.