MongoDB 6.0.14（Atlas免费层）中Motor/PyMongo创建搜索索引失败求助

核心原因 #

PyMongo 4.6.1的create_search_indexes方法未适配MongoDB 6.0.x版本中反向移植的向量搜索功能，导致发送了错误的命令，触发CommandNotFound报错。MongoDB 6.0.x反向移植的搜索索引API与原生7.x版本存在细微差异，旧版PyMongo未针对这种情况做兼容处理。

解决步骤 #

1. 升级PyMongo到最新兼容版本 #

PyMongo 4.7.0及后续版本已修复了对MongoDB 6.0.x反向移植向量搜索功能的支持，直接升级即可解决问题：

pip install --upgrade pymongo>=4.7.0

2. 手动执行索引创建命令（临时替代方案） #

如果暂时无法升级PyMongo，可以绕过create_search_indexes方法，直接调用command方法执行正确的createSearchIndexes命令：

from pymongo import MongoClient

client = MongoClient("你的Atlas连接字符串")
db = client["你的数据库名"]
collection = db["你的集合名"]

# 构造搜索索引模型（和SearchIndexModel结构一致）
index_model = {
  "name": "向量搜索索引名称",
  "type": "search",
  "definition": {
    "mappings": {
      "dynamic": False,
      "fields": {
        "向量字段名": {
          "dimensions": 1536,
          "similarity": "cosine",
          "type": "knnVector"
        }
      }
    }
  }
}

# 执行创建命令
result = collection.command("createSearchIndexes", indexes=[index_model])
print("索引创建结果:", result)

3. 确认客户端API版本配置 #

连接Atlas时，确保指定了正确的Server API版本，避免兼容性问题：

from pymongo import MongoClient
from pymongo.server_api import ServerApi

client = MongoClient(
    "你的Atlas连接字符串",
    server_api=ServerApi('1')
)

关于是否为PyMongo 4.6.1的Bug #

是的，这属于PyMongo 4.6.1的兼容性Bug。该版本发布时，MongoDB 6.0.x的向量搜索反向移植功能尚未普及，PyMongo未针对这种特殊版本做命令适配，导致调用create_search_indexes时发送了不被6.0.14支持的命令。升级到4.7.0及以上版本即可修复。

内容的提问来源于stack exchange，提问作者Warped Pixel