milvus数据库部署报错：illegal connection params or server unavailable | Fail connecting to server on xxx

最新推荐文章于 2025-09-23 01:55:38 发布

原创最新推荐文章于 2025-09-23 01:55:38 发布 · 2.4k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#数据库 #milvus

1.版本配置

在部署graphrag遇到的问题，我的milvus和pymilvus配置如下

milvusdb/milvus:v2.4.9

pymilvus==2.5.3

2.报错信息如下

illegal connection params or server unavailable

Fail connecting to server on xxx

无效的连接参数:

pymilvus.exceptions.MilvusException: <MilvusException: (code=2, message=Fail connecting to server on localhost:19530, illegal connection params or server unavailable)>

连接超时:

pymilvus.exceptions.MilvusException: <MilvusException: (code=2, message=Fail connecting to server on localhost:19530. Timeout)>

3.解决办法

a.docker容器均正常运行

b.清除环境变量来暂时禁用代理设置

找到/root目录下的.bashrc文件，在最后添加

export http_proxy=""

export https_proxy=""

source ~/.bashrc

根本原因：代理设置会干扰 Docker 容器之间的网络，导致连接失败。

解决方案：要解决此问题，请通过清除环境变量来暂时禁用代理设置

一旦禁用代理，重新连接到 Milvus 将按预期工作。

4.Milvus连接测试代码

from pymilvus import MilvusClient, MilvusException

if __name__ == '__main__':
    try:
        uri = 'http://47.103.8.209:19014'
        client = MilvusClient(uri=uri)
        if client.has_collection(collection_name="demo_collection"):
            client.drop_collection(collection_name="demo_collection")
        client.create_collection(
            collection_name="demo_collection",
            dimension=768,  # The vectors we will use in this demo has 768 dimensions
        )
        print(client.list_collections())
        # 可以添加一个简单的测试来确保连接成功
        print("连接成功")
        # logger.info(f"Successfully connected to Milvus at {uri}")
    except MilvusException as e:
        print(e)