Milvus创建HNSW索引报错求助：efConstruction及M参数超出范围

第一个报错：efConstruction参数超出范围 #

报错信息：

MilvusException: <MilvusException: (code=65535, message=efConstruction out of range: [1, 2147483647])>

• 原因：efConstruction是HNSW索引构建阶段的核心参数，用于平衡索引构建速度和召回率，Milvus要求其取值必须在[1, 2147483647]区间内。你最初设置的参数值超出了这个范围，或者参数传递时存在格式错误，导致触发该报错。向量维度30552不会直接引发这个参数范围问题。

第二个报错：M参数超出范围 #

调整参数后出现新报错：

MilvusException: <MilvusException: (code=65535, message=M out of range: [1, 2048])>

• 原因：你的索引配置存在多处关键错误：
  • 索引类型错误：HNSW对应的索引类型应为HNSW，而非配置中的bb
  • 度量类型错误：Milvus不支持ss这种度量类型，常用合法值为L2（欧氏距离）、IP（内积）等
  • 参数混用：nlist是IVF系列索引的专属参数，HNSW索引不需要该参数；HNSW的必填核心参数为M（每个节点的最大连接数，范围[1,2048]）和efConstruction
  • 由于索引类型配置错误，Milvus可能误识别为其他需要M参数的索引，但你未正确配置M或配置值超出范围，从而触发报错

正确配置示例 #

针对30552维度的向量，创建HNSW索引的合法配置如下：

{
    'metric_type': 'L2',  # 根据业务需求选择L2或IP
    'index_type': 'HNSW',
    'params': {
        'M': 16,          # 取值范围[1,2048]，高维度可适当增大
        'efConstruction': 40  # 取值范围[1,2147483647]，需根据召回率需求调整
    }
}

额外建议 #

• 高维度向量下，M可设置在16-64之间，efConstruction可设置在40-200之间，具体需根据查询性能和召回率需求做测试调优
• 确保所有参数的键名和取值完全符合Milvus官方定义，避免拼写错误或参数混用

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