MongoDB 5.0 将 transactionLifetimeLimitSeconds 默认值从60秒降为30秒，不手动调整会导致长事务被意外中止；该参数需显式设回60秒（动态或配置文件），且仅对新事务生效。
直接说结论：MongoDB 4.0 的多文档事务在 5.0 中完全保留且默认启用，但 transactionLifetimeLimitSeconds 默认值从 60 秒降为 30 秒，不改会导致长事务被意外中止——这是升级后最常踩的坑。
确认 featureCompatibilityVersion 已设为 "4.0"
5.0 不接受低于 4.0 的 FCV。如果升级前是 3.6 或更早，必须先升到 4.0 并运行：
db.adminCommand( { setFeatureCompatibilityVersion: "4.0" } )
否则 mongod 启动会失败，日志里报 featureCompatibilityVersion must be at least 4.0。检查当前值用：
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
- FCV 必须在所有节点（副本集成员、配置服务器、分片）上统一设置，不能只设主节点
- 设完 FCV 后必须重启
mongod，仅重载配置无效 - 设成 "4.0" 后无法再降级回 3.6；若需降级，只能退到 4.0.x 最新补丁版
事务超时参数变更必须手动覆盖
MongoDB 5.0 将 transactionLifetimeLimitSeconds 默认值从 60 改为 30，而很多业务代码依赖 60 秒窗口做批量导入或跨集合校验。不调整就会出现：
Transaction 12345 has exceeded the 30s timeout
解决方法是在 /etc/mongod.conf 的 setParameter 区块显式恢复：
setParameter: transactionLifetimeLimitSeconds: 60
- 该参数是动态可调的，改完无需重启，执行
db.adminCommand({setParameters:1,"transactionLifetimeLimitSeconds":60})即刻生效 - 但生产环境建议写进配置文件，避免服务重启后丢失
- 注意：此参数对已开启的事务不生效，只影响新开启的事务
驱动与客户端代码需验证 writeConcern 兼容性
5.0 强化了对 writeConcern 的语义一致性要求，尤其当事务内混用 w: "majority" 和 w: 1 时，可能触发 InvalidOptions: write concern w:1 is not valid for transactions 错误。
根本原因是：事务内所有操作必须使用相同 writeConcern，且不能为 w: 1（因无法保证多数派确认）。
- 检查应用层是否硬编码了
w: 1到事务 session 中 - Node.js 驱动需 ≥ 4.13，Python PyMongo ≥ 4.7，Java Driver ≥ 4.11 —— 旧版本在 5.0 下可能静默忽略
w导致数据丢失风险 - 测试时用
mongo --eval "db.runCommand({beginTransaction:1, writeConcern:{w:'majority'}})"快速验证服务端响应
别漏掉 TTL 索引里的 NaN 值
5.0 开始，expireAfterSeconds: NaN 被当作 0 处理，导致本该长期保留的文档被立即清理。这种索引常见于历史归档逻辑中，升级前必须人工筛查：
db.runCommand({ listIndexes: "logs" }).cursor.firstBatch.forEach(i => {
if (i.expireAfterSeconds !== undefined && isNaN(i.expireAfterSeconds)) {
print("Found NaN TTL in", i.name);
}
})
- 修复方式不是删索引，而是重建：
db.logs.dropIndex("createdAt_1")→db.logs.createIndex({createdAt: 1}, {expireAfterSeconds: 3600}) - 这个行为变更不报错、不告警，只有数据莫名消失后才暴露，务必在预发环境跑一周观察
- 所有含 TTL 的集合都要查，包括
system.profile等系统集合（如果启用了 Profiling）
真正麻烦的从来不是命令敲得对不对，而是那些没报错、没日志、却让数据在某天凌晨三点开始悄悄消失的隐性兼容问题。FCV、TTL、事务超时这三项，必须逐个确认，不能靠“应该没问题”跳过。
