pymongo 4.0 移除 cursor.count() 因其语义误导、分片集群下结果不可靠，且与 mongodb server 端 count 命令弃用同步；应改用 collection.count_documents()（带条件精确计数）或 estimated_document_count()（无条件快速估算）。
PyMongo 4.0 移除了 cursor.count()，不是因为“不想要计数功能”，而是因为它在语义、性能和一致性上长期存在问题，官方选择用 count_documents() 明确替代。
为什么 cursor.count() 被彻底移除
这个方法从 PyMongo 3.7 就开始抛 DeprecationWarning，到 4.0 直接删除。根本原因有三点：
-
cursor.count()表面是“游标计数”，实际却绕过游标逻辑，直接发一个count命令——它不走find的执行路径，也不受游标设置（如skip、limit、sort）影响，容易误导开发者以为“这是当前查询结果的行数” - 在分片集群中，
count命令对无条件全表统计（即空查询）返回值不可靠：可能漏掉orphaned documents，或受chunk migration中间状态干扰 - 它和 MongoDB Server 端行为脱节：从 MongoDB 4.0 开始，Server 已将
count命令标记为 deprecated，推荐统一走aggregate或countDocuments命令
count_documents() 和 estimated_document_count() 怎么选
二者都挂在 Collection 对象上，但用途完全不同：
-
count_documents({})：带查询条件的精确计数，走索引 + 全匹配扫描，结果准确，但可能慢（尤其无索引时） -
estimated_document_count()：无条件快速估算，读取集合元数据中的文档数快照（collstats），不走查询引擎，快但不保证实时准确（例如刚插入还没刷盘） - 如果你原来写的是
collection.find({}).count()，升级后应优先改为collection.estimated_document_count()；如果带条件（如{"status": "active"}），必须用count_documents(condition)
常见误改：别在游标上调用 count_documents()
错误写法：cursor.count_documents({}) —— Cursor 对象根本没有这个属性，会报 AttributeError: 'Cursor' object has no attribute 'count_documents'
- 正确路径只有两条：
collection.count_documents(condition)或collection.estimated_document_count() - 如果你已有
cursor = collection.find(condition)，不能复用它，得重新调用collection.count_documents(condition)（注意：条件要一致） - 不要试图“省一次网络请求”而把
find和count_documents合并——它们是两个独立命令，底层不共享执行上下文
升级时最容易被忽略的一点
很多代码里 count() 是链式调用的，比如 collection.find(...).sort(...).count()。这种写法在 4.x 不仅失效，还掩盖了真实意图：你到底想对“排序后的前 N 条”计数，还是对“满足条件的全部文档”计数？count_documents() 强制你把条件显式写出，反而暴露了逻辑漏洞——比如你本意是查“最近 10 条活跃用户”，却误用了全量条件去计数。
