MongoDB Java驱动4.0+是否会重试DBCursor.next()/hasNext()方法？

MongoDB的可重试读设计，核心是让驱动在遇到网络中断、主节点选举切换这类瞬时错误时，自动为符合条件的读请求重发，无需业务代码手动实现重试。

需要注意4.0+版本的Java驱动将API实现拆成了两个完全独立的分支，重试能力的覆盖范围也存在明确差异：

• 新版通用API分支：对应MongoCollection系列方法返回的游标实现，从初始查询发起、到后续调用next()/hasNext()拉取数据批次的全流程，只要满足可重试读的触发条件，都会被纳入自动重试的覆盖范围。
• 遗留（Legacy）API分支：对应旧版DB对象体系下DBCollection.find()返回的DBCursor实现，驱动代码层面并未将可重试读逻辑下沉到这个分支的实现管线中。

核心结论：MongoDB Java 4.0+ 版本不会对DBCursor.next()或DBCursor.hasNext()方法执行自动重试逻辑。
不仅如此，即使是通过DBCursor发起的初始查询请求，因为走的是独立的遗留实现链路，也不会自动套用新版的可重试重试规则。

实践层面需要注意：

• 项目中如果使用遗留DBCursor处理查询，遇到游标拉取阶段的瞬时报错，需要业务代码自行实现重试逻辑，无法依赖驱动自带的可重试读能力。
• 如果需要覆盖游标全流程的自动重试，需要将代码切换到新版MongoCollection对应的API体系，使用新版游标实现替代旧的DBCursor。

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