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 级别，三者缺一不可。
