MongoDB向量搜索：pymongo抛出OperationFailure（堆为空）错误的解决咨询

异常含义 #

pymongo.errors.OperationFailure是MongoDB返回操作执行失败时抛出的通用异常，针对你遇到的具体错误：

• 错误信息The heap is empty表明MongoDB从节点在处理向量搜索查询时出现了临时内存/内部资源调度异常
• 错误码8（UnknownError）属于通用未知错误码，结合随机出现、重试可恢复的特征，说明这不是索引或查询逻辑的永久性问题，而是从节点在高负载或资源紧张时的临时故障
• 对比Atlas搜索无此问题，是因为Atlas搜索由专用搜索集群处理计算，而你直接查询副本集从节点时，计算压力由从节点自身承担

可调整的配置/解决方案 #

• 修改读偏好设置：将连接URI中的readPreference=secondary改为readPreference=secondaryPreferred，这样当从节点不可用或出现异常时，驱动会自动切换到主节点执行查询；如果业务允许读主节点，也可直接设置为readPreference=primary
• 升级从节点资源：若为自托管副本集，增加从节点的内存配置。向量搜索涉及大量向量计算，内存不足是触发"堆为空"异常的常见原因
• 添加查询重试逻辑：在代码中捕获pymongo.errors.OperationFailure，当异常的code为8或errmsg包含"The heap is empty"时，自动重试请求（你已验证重试可正常返回结果）
• 升级MongoDB版本：当前使用的6.0.8存在向量搜索在从节点上的临时bug可能性，建议升级到6.0系列的最新补丁版本，官方可能已修复此类资源调度问题
• 切换至专用搜索集群：如果业务允许，改用Atlas搜索处理向量查询（如你提到的从未出现该错误），避免让副本集从节点承担高负载的向量计算任务

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