事务提交后数据未更新，根本原因是事务未生效：需满足副本集/分片集群部署、正确版本与配置、显式会话绑定、避免禁用操作及超时，任一环节缺失均导致操作脱离事务上下文。
事务提交后数据没更新，大概率不是“提交失败”，而是事务根本没生效——要么环境不支持，要么代码没写对，要么操作本身被静默跳过。
事务未生效的底层原因：版本与部署不匹配
MongoDB 事务不是开箱即用的功能，它对部署形态和版本有硬性要求：
- 单节点
mongod实例完全不支持事务；必须是至少 3 节点的副本集（replicaSet），或分片集群（sharded cluster） - 副本集最低要求 MongoDB
4.0；分片集群最低要求4.2 - 所有节点的
featureCompatibilityVersion必须 ≥ 对应最低值，否则事务命令会被忽略或报错 - 连接字符串必须含
replicaSet=xxx参数，例如mongodb://host1:27017,host2:27017/?replicaSet=rs0；写成mongodb://localhost:27017就无效
Java/PyMongo 中最常漏掉的会话绑定
事务操作必须显式传入同一个 session 实例，否则每个操作都在独立上下文中执行，形同无事务：
- Java 中：所有
collection.insertOne()、updateOne()等调用都必须带.session(session)参数 - PyMongo 中：
collection.update_one({...}, {...}, session=session)—— 漏掉session=就等于没进事务 - 不要在事务块内新建
session或复用已结束的session；每次with client.start_session()应配对一个完整事务体 - 事务内调用
find()也需传session，否则读取的是非事务快照，可能看到旧数据
事务里写了不支持的操作，失败却不报错
MongoDB 事务中某些操作被禁止，但错误表现很隐蔽——不是抛异常，而是直接跳过或静默失败：
-
createCollection、dropCollection、createIndex在事务中不被允许；若执行，会报CommandNotSupportedInTransaction，但若没 catch 就吞掉 - 事务超时（默认 60 秒）后，后续任何操作（包括
commitTransaction）都会失败，错误可能是InvalidOperation或ConnectionFailure - 写操作超出
16MBoplog 单条限制（如大文档批量更新）会导致事务中止，但客户端可能只收到模糊的WriteConcernError - 事务中调用外部 HTTP、Kafka、文件 I/O 等操作，既不参与原子性，也不触发回滚——数据库更新成功了，但消息没发出去，业务就断链
你以为提交了，其实事务早被自动终止
服务端对空闲事务有强制清理机制，transactionLifetimeLimitSeconds 默认为 60 秒。一旦超时，事务状态即失效：
- 客户端调用
commit_transaction()时，服务端已无对应上下文，返回ConnectionFailure或NoSuchTransaction - PyMongo 的
max_commit_time_ms只限制 commit 阶段耗时，不延长事务生命周期；设再大也没用 - Java 驱动里没等
session.commitTransaction()返回就释放资源，或没处理InterruptedException，也会导致“看似提交实则丢弃” - 生产环境务必检查
db.serverStatus().metrics.operation.write.conflicts和wt_txn_update_conflict计数——高冲突意味着事务频繁重试甚至被中止，表面成功实则数据未落地
真正难的不是写 startTransaction，而是确认每一步都落在事务上下文里：连接串、会话对象、操作参数、服务端配置，缺一不可。任何一个环节脱钩，数据就不会更新——它根本就没进事务。
