为何带索引的MongoDB GeoJson查询抛出错误？

错误详情 #

planner returned error :: caused by :: unable to find index for $geoNear query, full error: {'ok': 0.0, 'errmsg': 'error processing query: ns=sites_v1.sitesTree: GEONEAR  field=location maxdist=1.79769e+308 isNearSphere=0\nSort: {}\nProj: {}\n planner returned error :: caused by :: unable to find index for $geoNear query', 'code': 291, 'codeName': 'NoQueryExecutionPlans', '$clusterTime': {'clusterTime': Timestamp(1702483302, 11), 'signature': {'hash': b'\x87o\x04\x80! \xdc\xbf\x88\x0e\xf8/D\xbe\x18\xc8F\xe1Q\xa2', 'keyId': 7261788343090806786}}, 'operationTime': Timestamp(1702483302, 11)}

问题场景 #

• GeoJson字段名为location，集合内存在与查询坐标几乎完全一致的文档
• 使用$near地理查询时触发上述错误

相关代码 #

from db_connect import get_database
# from pymongo import GEOSPHERE

dbname = get_database()

sites = dbname["sites"]

# sites.create_index(["location", "2dsphere"])

query = {
    "location": {
        "$near": {
            "$geometry": {
                "type" : "Point",
                "coordinates": [-86.592117, 31.179634]
            },
            "$maxDistance": 1000
        }
    }
}

# explain =  sites.find(query).explain()
# print(explain)

排查过的资源 #

• PyMongo地理空间查询官方文档
• MongoDB 2dsphere索引邻近查询官方文档

解决方法 #

1. 修正索引创建语法 #

原代码中索引创建写法错误，且被注释未执行。正确的2dsphere索引创建方式如下：

from pymongo import GEOSPHERE
# 必须导入GEOSPHERE常量
sites.create_index([("location", GEOSPHERE)])

注意：

• 索引参数需是元组组成的列表，而非单纯的字符串列表
• 必须使用GEOSPHERE常量，不能直接写字符串"2dsphere"

2. 确认索引生效 #

执行上述代码后，通过MongoDB客户端查看集合索引，确保location字段上存在类型为2dsphere的索引。

3. 重新执行查询 #

索引创建完成后，再运行$near查询即可正常执行。

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