From d9e26eba654680ced5944a814bb2cf713f1464d4 Mon Sep 17 00:00:00 2001 From: Petrus Han Date: Tue, 26 Aug 2025 23:32:26 +0800 Subject: [PATCH] fix: rag/milvus clarify full-text search warning with actionable guidance (#24570) --- api/core/rag/datasource/vdb/milvus/milvus_vector.py | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/api/core/rag/datasource/vdb/milvus/milvus_vector.py b/api/core/rag/datasource/vdb/milvus/milvus_vector.py index 112f07844c..8ae616fa77 100644 --- a/api/core/rag/datasource/vdb/milvus/milvus_vector.py +++ b/api/core/rag/datasource/vdb/milvus/milvus_vector.py @@ -259,8 +259,16 @@ class MilvusVector(BaseVector): """ Search for documents by full-text search (if hybrid search is enabled). """ - if not self._hybrid_search_enabled or not self.field_exists(Field.SPARSE_VECTOR.value): - logger.warning("Full-text search is not supported in current Milvus version (requires >= 2.5.0)") + if not self._hybrid_search_enabled: + logger.warning( + "Full-text search is disabled: set MILVUS_ENABLE_HYBRID_SEARCH=true (requires Milvus >= 2.5.0)." + ) + return [] + if not self.field_exists(Field.SPARSE_VECTOR.value): + logger.warning( + "Full-text search unavailable: collection missing 'sparse_vector' field; " + "recreate the collection after enabling MILVUS_ENABLE_HYBRID_SEARCH to add BM25 sparse index." + ) return [] document_ids_filter = kwargs.get("document_ids_filter") filter = ""