springboot MongoDB 事务

最新推荐文章于 2025-07-01 22:52:53 发布

转载最新推荐文章于 2025-07-01 22:52:53 发布 · 5.5k 阅读

13 ·

CC 4.0 BY-SA版权

原文链接：https://cloud.tencent.com/developer/article/1502189

springboot 专栏收录该内容

14 篇文章

订阅专栏

本文介绍如何在SpringBoot环境中整合MongoDB副本集事务，并详细解释了版本要求、配置步骤及注意事项，包括如何处理副本集事务限制。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

前言

有玩过mongodb的朋友大概会知道mongodb4.0版本已经可以支持多文档副本集事务。而最新版本4.2更是支持分片事务，即真正的支持分布式事务。不过当时我使用mongodb，其最新版本为4.10，4.2版本还没发布，因此本文还是以4.0版本的副本集事务来讲解。

事务整合

1、使用事务的前置条件

mongodb版本大于等于4，本文mongodb版本为4.10版本
mongodb搭建了副本集，本文mongodb为一主两从
本文使用的springboot版本为springboot2+版本，具体说是springboot2.1.6版本

2、pom.xml引入

<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-mongodb</artifactId>
</dependency>

3、application.yml配置如下内容

spring:
  data:
    mongodb:
      uri: mongodb://root:123456@localhost:27017,localhost:27018,lcoalhost:27017
      database: springboot-learning
      authentication-database: admin
      transactionEnabled: true
      #field-naming-strategy: org.springframework.data.mapping.model.SnakeCaseFieldNamingStrategy
      #驼峰转下划线
      property-naming-strategy: SNAKE_CASE

其中authentication-database为需要认证授权的数据库。
database为业务数据库。
transactionEnabled为自定义是否开启事务，为什么需要这个属性后边会说明。
property-naming-strategy也是自定义属性，用来用来映射当代码的属性是驼峰比如userName，映射到mongodb就为user_name,其实spring-data-common就有提供一个叫做field-naming-strategy就是用来实现类似功能，那为啥我重新造了一个轮子。那是因为当时我使用了没有达到我想要的效果

4、实现事务代码逻辑

@Bean
  @ConditionalOnProperty(name="spring.data.mongodb.transactionEnabled",havingValue = "true")
  MongoTransactionManager transactionManager(MongoDbFactory factory){

    return new MongoTransactionManager(factory);
  }

现在来讲讲为啥使用transactionEnabled这个自定义属性，当时是因为我所在项目组，其线上环境mongodb还不是副本集，如果直接加上面的代码，而mongodb不是副本集，则进行crud时，会报错，因此加了这个属性本质就是为了兼容

5、在需要使用事务的类或者方法上加上@Transactional注解

@Transactional
  public UserDTO saveUser(UserDTO userDTO) {

    User user = getUser(userDTO);

    User dbUser = userDao.saveUser(user);
    if(ValidateTransaction.YES.getValue().equals(userDTO.getValidateRollBack())) {
      throw new RuntimeException("验证事务回滚");
    }
    UserDTO dbUserDTO = modelMapper.map(dbUser,UserDTO.class);
    dbUserDTO.setGender(dbUser.getGender().getValue());



    return dbUserDTO;
  }

springboot整合mongodb副本集事务存在的坑点

副本集事务只对已经存在的mongodb中的集合起作用，如果要进行操作的集合，在mongodb中还没有，必须得先创建该集合，否则当该集合进行插入操作时，会报类似“Cannot create namespace sampledb_200.demo in multi-document transaction ”的错误

总结

通过这个例子，给我的最大的感受是springboot确实是一个神器，仅仅通过简单的几行代码就可以实现mongodb事务。而如果不使用springboot来整合，直接使用mongodb官方提供的api，就要写一坨代码。还有一点，mongodb4.2之前版本的副本集事务存在最大修改16MB、事务执行时间不能过长的限制，而这些问题在4.2版本已经得到解决，感兴趣的朋友，可以跟进下