多实例部署下$inc自增id必然冲突，因其“读-改-写”非原子；应使用findoneandupdate配合专用counters集合实现单文档原子自增，并注意returndocument、错误处理及本地号段缓存。

多实例部署下直接用 $inc 做自增 ID 必然冲突——因为每个 Node.js 实例都独立读取、+1、写回，中间没有全局协调，结果就是重复 ID 或跳号。这不是配置问题，是设计层面的原子性缺失。

为什么 $inc 在多实例下不可靠

$inc 本身是原子的，但“取当前值 → +1 → 返回”这个业务逻辑不是。多个实例并发执行时，可能同时读到同一个旧值（比如 100），各自加 1 后都写回 101，ID 就撞了。MongoDB 不提供跨连接的序列锁，$inc 只保证单次更新原子，不保证业务语义原子。

• 现象：订单号、用户编号等字段出现重复、跳变、甚至负数（如果没设初始值）
• 场景：Node.js 部署 ≥2 个进程（PM2 cluster、K8s 多 Pod、负载均衡后多机器）
• 关键点：冲突根源不在驱动或网络，而在“读-改-写”流程未被封装进一次原子操作

必须用 findOneAndUpdate 模拟序列器

真正可行的方案是把自增逻辑压进单文档的原子更新里，靠 MongoDB 的单文档更新原子性兜底。核心是建一个专用集合（如 counters），每类 ID 对应一条文档。

OC SSH Tunnel Node Recovery

诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。

下载

• 初始化：首次插入时用 upsert: true，避免手动创建遗漏
• 查询条件必须基于唯一键：_id: "order_seq"（不能用普通字段，否则无法锁定单文档）
• 返回值必须设 returnDocument: "after"，否则拿到的是旧值，无法用于后续逻辑
• 示例命令：

  db.counters.findOneAndUpdate( { _id: "order_seq" }, { $inc: { seq: 1 } }, { upsert: true, returnDocument: "after" } )

Node.js 驱动里容易踩的三个坑

即使用了 findOneAndUpdate，Node.js 官方驱动（4.x+）默认行为和错误处理仍会悄悄破坏一致性。

• returnDocument 默认是 "before"，必须显式写成 "after"，否则你拿到的 result.value.seq 是旧值
• 没检查 result.matchedCount：为 0 表示没匹配到（比如 _id 错了），但代码可能继续用 undefined.seq 导致崩溃
• 没处理 11000 错误码（唯一键冲突）：如果业务层还写了唯一索引校验，冲突时不会走 matchedCount === 0 分支，而是抛错，必须单独捕获

并发量大时别硬扛，加一层本地缓存

高频取号（比如每秒上千次）直接打到 MongoDB，会成为瓶颈。可以在每个 Node.js 实例内存里缓存一段号段（如预取 100 个），用完再批量取下一段。

• 缓存结构建议：{ key: "order_seq", next: 10001, max: 10100 }，用 next++ 直出，无锁
• 注意失效：进程重启后缓存丢失，但数据库序列器仍在，不会错乱
• 不要跨实例共享缓存（如 Redis），那又回到分布式协调问题，反而更重

最易被忽略的一点：序列文档的 _id 必须是字符串字面量（如 "user_id"），不能是动态拼接却没校验的变量——一旦传入空值或非法字符，findOneAndUpdate 会静默匹配失败，后续所有 ID 都从 0 开始疯长。