distinct仅在有读权限、字段存在且类型可比较时成功；单节点需驱动≥4.2且连接字符串不含replicaSet参数；字段名须为字符串字面量；嵌套字段点号合法但空值文档被跳过；返回纯数组，无统计能力，频次统计应选$group；Node.js驱动中需显式.toString()处理ObjectId；超16MB报错需改聚合分页；分片环境须确保各shard索引覆盖，避免类型混淆。
distinct 方法的基本用法和常见报错
直接调用 distinct 是最简方式，但它只在集合有读权限、字段存在且类型支持比较时才成功。常见错误是 Command failed: distinct command is only supported on replica sets and sharded clusters——这说明你连的是单节点 mongod 实例（非副本集），而旧版驱动或 shell 在某些配置下会误判；实际从 MongoDB 4.2 起，单节点也支持 distinct，关键是驱动版本和连接字符串里不能带 ?replicaSet= 这类误导参数。
- 确保连接 URL 不含冗余 replicaSet 参数（单机开发环境尤其注意）
- 字段名必须是字符串字面量，不能是变量拼接后未校验的值，否则抛
TypeError: string expected - 如果字段嵌套（如
user.profile.city），点号写法合法，但若某文档中user为 null 或缺失，该文档会被跳过，不报错也不告警
distinct 和聚合 pipeline 中 $group 的取舍
distinct 返回的是纯数组（如 ["bj", "sh", "gz"]），没有计数、排序或过滤能力；而用 aggregate([{$group: {_id: "$city"}}]) 虽然多写几行，却能立刻叠加 $count、$sort 或配合 $match 做条件去重（比如只取 status 为 active 的用户城市）。
- 只要需求只是“列出所有不重复值”，用
distinct更轻量，网络传输少、服务端压力小 - 如果后续要统计频次（如每个城市多少人），别硬套
distinct+ 多次countDocuments，直接上$group+$sum: 1 - 注意：空字符串
""、null、undefined在distinct中视为不同值；而$group对null和缺失字段通常归为同一组，行为不一致
在 Node.js 驱动中正确调用 distinct 并处理结果
MongoDB Node.js 驱动 v4+ 的 distinct() 方法返回 Promise，但**不自动展开嵌套数组字段**——比如字段存的是 ["a","b"]，distinct("tags") 返回的是整个数组作为唯一项，不是把 "a" 和 "b" 拆开去重。真要元素级去重，得用 $unwind 配合聚合。
- 调用示例：
const cities = await db.collection('users').distinct('address.city'); - 加查询条件（如只查启用用户）：
await coll.distinct('status', { isActive: true }); - 字段值是 ObjectId 类型？结果数组里是
ObjectId实例，不是字符串；需要转成字符串再 JSON 序列化时，得显式调用.toString() - 结果超 16MB（MongoDB 单次响应上限）？
distinct会直接失败，此时必须切分条件或改用聚合 +$limit分批拉取
distinct 在分片集群上的行为差异
分片环境下，distinct 请求由 mongos 路由到各 shard 并合并结果，但合并逻辑是“去重后并集”，不是简单拼接。这意味着：如果某个值在两个 shard 上都存在，最终结果只出现一次；但如果一个 shard 返回 ["a"]，另一个因索引不全漏掉 "a"，结果就不可靠——所以务必保证被查字段在所有 shard 上都有对应索引。
- 检查索引是否覆盖所有分片：
db.runCommand({listIndexes:"users"})并确认每个 shard 的输出里都有{ "address.city": 1 } - 避免在未分片字段上执行
distinct：mongos 会广播请求到所有 shard，效率低且易超时 - 分片键本身（如
_id）做distinct最快，因为 mongos 可直接查 config server 元数据，不触达数据节点
"123" 和数字 123 在 distinct 中算两个不同值，但前端展示时可能都渲染成 “123”，导致你以为漏了数据。查之前先用 aggregate 看下实际类型分布，比反复刷页面更省时间。 
