MongoDB存在文档但db.user.count()返回0的原因排查

问题现象 #

• 已完成用户数据写入
• 执行db.user.count()返回结果为0
• 执行show collections可查询到对应集合存在，执行db.<对应集合名>.count()同样返回0
• 通过Mongo Compass可确认集合内实际存储有1条文档

排查解决步骤 #

• 首先核对集合名拼写与大小写
  MongoDB集合名严格区分大小写，对不存在的集合直接执行count()不会抛出异常，会直接返回0。先在shell中执行show collections获取精确的集合名称，避免因为集合名是Users/user_info这类和你输入的user不匹配，查询到隐式创建的空集合。
• 确认连接节点与读偏好配置一致
  如果是副本集/分片集群部署，shell默认可能读取从节点，刚写入的数据未完成主从同步时就会返回空结果；而Compass默认连接主节点，能查到最新写入的数据。可以先在shell执行db.isMaster()确认当前连接节点角色，临时指定读主节点再查询验证：

  db.user.count({readPreference: "primary"})
  

• 替换废弃的count()方法为官方推荐的准确统计方式
  旧版db.collection.count()基于集合元数据做统计，在分片集群、写入后元数据未刷新、存在孤儿文档的场景下会返回不准确结果，目前官方已标记该方法废弃。直接使用扫描实际文档的统计命令即可得到准确结果：

  // 统计集合实际文档总数，和Compass展示结果一致
  db.user.countDocuments({})
  

• 检查当前会话是否存在全局查询过滤
  如果之前在shell中设置过全局查询过滤器（比如过滤已删除数据的规则），count()会自动携带该过滤条件，可能把已存在的文档过滤掉。执行db.getQueryFilter()可查看当前全局过滤规则，存在规则时执行db.unsetQueryFilter()清除后再查询即可。

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