如何正确使用MongoDB $count操作符及解决语法无效问题

出现$count无效语法的报错，可按照以下场景逐一排查修复：

• 占位符未替换，查询目标搞混
  官方文档示例中的db.collection是通用占位符，代表你实际要查询的目标集合名称，不能直接照搬不修改。
  你当前写的db.collection.aggregate([{$count: "timers"}])刚好踩中了这个典型坑：本来要统计timers集合的文档总数，正确逻辑应该是把查询目标换成timers，结果反而把timers写在了$count后面作为输出结果的计数字段名，还留着通用占位符collection当查询的集合名，查询路径不对的情况下就容易触发解析异常。
• 服务端版本不兼容
  聚合管道中的$count操作符是MongoDB 3.4版本才正式上线的特性，如果你的服务端版本低于3.4，语句解析器无法识别这个聚合阶段，就会直接抛出无效语法的报错。
  可以先运行db.version()查看当前服务端版本，如果版本确实低于3.4，就替换成低版本兼容的聚合写法实现同等统计效果：

  db.timers.aggregate([
    { $group: { _id: null, doc_count: { $sum: 1 } } }
  ])
  

• $count阶段的字段名不符合规则
  $count后面跟的字符串是最终返回结果中存储计数值的字段名，这个字段名有明确的格式要求：不能是空字符串、不能包含点号、不能以$符号开头，不符合规则就会直接触发语法校验失败。你写的"timers"作为输出字段名本身是合规的，但要检查书写过程中有没有漏引号、混入特殊字符的低级错误。
• 最终可直接运行的正确写法（3.4及以上版本）
  确认版本满足要求、集合名替换正确后，完整的统计语句结构如下：

  db.timers.aggregate([
    { $count: "total_documents" }
  ])
  

  运行后会返回类似{ "total_documents" : 57 }的结果，对应统计到的文档总数。

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