Node.js连接MongoDB分片集群必须通过mongos入口，不可直连shard；需正确配置分片键、预建索引、避免全分片扫描及聚合内存溢出。
Node.js连接MongoDB分片集群必须用mongos地址，不能直连单个shard
直接用mongoose.connect('mongodb://shard1:27018,shard2:27019/...')会失败——Mongoose不识别分片拓扑，只会当普通副本集处理，导致查询路由失效、写入丢失或报错not master。
正确做法是启动mongos进程作为统一入口，然后在Node.js中只连它：
-
mongos监听端口（默认27017），配置里指定--configdb指向配置服务器副本集 - Node.js连接字符串形如：
mongodb://localhost:27017/mydb?replicaSet=rs0（注意：即使连mongos，也建议加replicaSet参数防重连抖动） - 务必关闭
useUnifiedTopology: false——新版Mongoose（v6+）默认启用，但mongos兼容性更稳的是true（实测v6.12+已无问题，旧版需显式设为true）
分片键选错会导致查询变慢甚至全表扫描
MongoDB按分片键路由查询，如果查询条件不含分片键或其前缀，mongos只能广播到所有分片，性能退化成O(n)。
常见错误场景：
- 用
_id当分片键但应用层查{email: "a@b.com"}——没命中分片键，全分片扫描 - 选
createdAt做范围分片，却高频查{status: "paid"}——同样广播 - 复合分片键
{userId: 1, orderId: 1}，但只用{orderId: "xxx"}查——缺少前缀字段，无法路由
对策：分片键必须覆盖核心查询模式。node-elm类外卖系统优先选{city_id: 1, createdAt: -1}，兼顾地域隔离与时间局部性。
shardCollection必须在集合有索引后执行，否则报错no shard key index
MongoDB要求分片集合的分片键字段必须存在对应索引，且该索引必须以分片键开头。这个检查在sh.shardCollection()时触发，不是连接时。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
典型翻车步骤：
- 先
db.orders.insertMany([...])插入百万数据 - 再
sh.shardCollection("mydb.orders", {"userId": 1})——失败，提示缺失索引 - 补建索引
db.orders.createIndex({userId: 1})后重试——仍失败，因索引未生效或权限不足
安全流程：
- 创建集合前，先在
mongosh里执行db.orders.createIndex({userId: 1}) - 确认索引状态：
db.orders.getIndexes()看到{"key": {"userId": 1}, "name": "userId_1"} - 再运行
sh.shardCollection("mydb.orders", {"userId": 1}) - Node.js代码里无需额外操作，Mongoose照常
Model.find()即可
分片后count()和distinct()性能骤降，得换方案
分片环境下，db.collection.countDocuments({})或db.collection.distinct("status")需协调所有分片返回结果再聚合，延迟高、易超时。
实际项目中应规避：
- 页面显示“共XXX条订单”？改用近似值：维护一个
stats集合，每次写入/删除时用updateOne({type: "order_count"}, {$inc: {total: 1}}, {upsert: true}) - 下拉菜单要所有
status枚举？提前缓存到Redis，定时刷新 - 必须精确统计？加
maxTimeMS: 30000防hang住，捕获MaxTimeMSExpired错误并降级返回“暂不可用”
分片不是透明升级，每个API调用背后都藏着路由开销。最易被忽略的是聚合管道——$group阶段若没包含分片键，mongos会拉取全部数据到内存合并，瞬间打爆节点内存。
