如何给MongoDB的每个事务附加自定义标识符供排查

mongodb事务中需通过每个写操作的comment字段传递trace_id，格式为json.stringify({trace_id: ‘xxx’})，且须确保驱动≥4.0、mongodb≥5.0、profiling级别≥1才能在日志和currentop中查到。

事务里怎么塞自定义 trace_id 或 request_id

MongoDB 原生不支持在 session.startTransaction() 时传入业务标识字段，所有事务日志、慢查询、profiling 输出里都看不到你想要的 trace_id。直接往事务对象上挂属性（比如 session.myTraceId = 'xxx'）完全无效——服务端根本收不到。

可行方案只有一种：把标识符塞进 writeConcern 的 wtimeout 字段里“借道”传递，或者更稳妥地，用 comment 字段。MongoDB 5.0+ 对 comment 的支持已覆盖所有写操作和事务，且会透传到日志、currentOp、system.profile 和 Atlas 审计日志中。

• comment 必须是字符串，不能是对象或数字；建议统一用 json.stringify({trace_id: 'xxx', user_id: 'yyy'}) 格式，方便后续正则提取
• 不要用 wtimeout 模拟——它会被当作超时参数解析，可能意外中断事务
• 如果用的是旧版驱动（如 Node.js 3.x），需确认 comment 是否已随事务上下文透传；4.0+ 驱动默认支持

Node.js 中给 transaction 添加 comment 的实操写法

不是在 startTransaction() 调用里加，而是在每个具体的写操作（insertOne、updateOne 等）里显式传入 comment 选项。事务内所有操作共享同一个 session，但 comment 是 per-operation 的，必须每条都带。

await session.withTransaction(async () => {   await Collection.insertOne({ x: 1 }, {     session,     comment: JSON.stringify({ trace_id: 'req-abc123', route: '/api/order' })   });   await collection.updateOne({ _id: docId }, { $inc: { count: 1 } }, {     session,     comment: JSON.stringify({ trace_id: 'req-abc123', route: '/api/order' })   }); });

• 别试图在 session.startTransaction({ comment: 'xxx' }) —— 这个参数不存在，会被忽略
• 如果你封装了事务工具函数，记得把 comment 作为必传参数透传到每个 collection.*() 调用中
• 注意 JSON 字符串长度：MongoDB 限制 comment 最长 1024 字节，别塞完整上下文对象

怎么从 MongoDB 日志或 currentOp 里查这个 comment

启用 profiling 后，system.profile 文档里的 comment 字段会原样出现；在 db.currentOp() 输出里也能看到。但前提是：你得让 MongoDB 记录这些操作——默认 profile 级别是 0（不记录），至少设为 1（记录慢操作）或 2（全量）。

• 临时开启全量 profiling：db.setProfilingLevel(2)，仅用于排查，勿长期开启
• 查正在运行的带 trace_id 的事务：db.currentOp({ "secs_running": { $gt: 0 }, "comment": /req-abc123/ })
• 查历史慢操作：db.system.profile.find({ "comment": /req-abc123/, "millis": { $gt: 100 } })
• Atlas 用户可直接在 Performance Advisor 或 Query Profiler 界面按 comment 过滤

容易被忽略的兼容性坑

不是所有驱动版本都把 comment 透传进事务上下文。Java 驱动 4.3+、Python PyMongo 4.0+、Node.js MongoDB Driver 4.0+ 才保证事务内写操作携带 comment 并出现在日志中。旧版本即使写了也白搭。

• Go driver（mongo-go-driver）v1.8+ 才支持在 InsertOneOptions 等结构体中设置 Comment
• 如果你用的是 MongoDB 4.2 或更早版本，comment 在事务中不会写入 profiler，只能靠应用层打日志 + 关联 session ID
• 分片集群下，comment 会出现在 mongos 日志，但各 shard 的 system.profile 不包含该字段（除非开启 sharding.logAllShardOperations）

真正麻烦的不是加不上，而是加了却查不到——先确认驱动版本、MongoDB 版本、profiling 级别，三者缺一不可。