如何排查MongoDB事务中的WriteConflict写入冲突错误

• 开启MongoDB事务与命令的详细日志
  修改MongoDB配置文件（mongod.conf），提升事务和命令相关的日志级别，让MongoDB日志记录冲突发生时的具体命令、涉及文档ID及事务ID：

  systemLog:
    component:
      command:
        verbosity: 3
      transaction:
        verbosity: 3
  

  重启MongoDB后，日志会完整记录每个事务的执行轨迹，冲突发生时可直接查到触发问题的操作细节。

• 给代码中每个DB操作添加追踪日志
  用SLF4J等日志框架，给事务内的每一步读写操作打日志，标注操作类型、集合名、文档ID和当前事务ID（通过MongoClientSession获取）：

  log.debug("事务ID[{}]执行{}操作：集合={}, 文档ID={}", 
            session.getTransactionNumber(), "update", "user", userId);
  

  当冲突异常抛出时，通过日志可直接回溯到事务执行到哪一步出了问题。

• 增强异常捕获的上下文信息
  在事务链中捕获MongoWriteConflictException，同时输出事务执行过程中记录的操作轨迹。用ThreadLocal维护当前事务的操作列表，异常时打印：

  private static final ThreadLocal<List<String>> TRANSACTION_OPERATIONS = ThreadLocal.withInitial(ArrayList::new);
  
  // 每个操作执行前记录轨迹
  TRANSACTION_OPERATIONS.get().add("更新user集合，ID:" + userId);
  
  transactionalOperator.execute(status -> {
      return // 业务操作链
  }).doOnError(MongoWriteConflictException.class, e -> {
      log.error("事务触发WriteConflict，执行轨迹：{}", TRANSACTION_OPERATIONS.get(), e);
      TRANSACTION_OPERATIONS.remove();
  });
  

• 模拟并发场景复现问题
  用JUnit配合StepVerifier，或者JMeter工具，针对可疑业务接口发起高并发请求，主动复现WriteConflict。复现后结合MongoDB日志和代码日志，就能精准定位冲突的具体操作。

• 聚焦高风险操作
  MongoDB事务冲突大多源于同一文档的并发修改，优先排查事务中先读后写的操作，以及多个事务同时修改同一集合内同一文档的场景，这些是冲突高发区。

内容的提问来源于stack exchange，提问作者Nayan