Spring 多数据源环境下 @Transactional 注解的正确配置方法

胖浩小哥_6243

胖浩小哥_6243

2026-04-14

937人浏览

原创

Spring 多数据源环境下 @Transactional 注解的正确配置方法

在 Spring 应用中使用多个数据库时,单个 @Transactional 注解默认仅绑定到主事务管理器,若需对第二数据源执行写操作(如 save/update),必须显式指定对应的数据源事务管理器,否则会抛出 “no transaction is in progress” 异常。

在 spring 应用中使用多个数据库时,单个 `@transactional` 注解默认仅绑定到主事务管理器,若需对第二数据源执行写操作(如 save/update),必须显式指定对应的数据源事务管理器,否则会抛出 “no transaction is in progress” 异常。

当项目中配置了多个数据源(如本例中的 ds 和 mdmDs)及对应的 SessionFactory 与 HibernateTransactionManager 时,Spring 的声明式事务机制不会自动识别多事务管理器上下文。@Transactional 默认使用名为 transactionManager 的 Bean(即第一个定义的事务管理器),而对第二个数据源(如 mdmTxnMang)的操作若未显式关联其事务管理器,则 Hibernate 无法获取有效事务上下文,导致 javax.persistence.TransactionRequiredException: no transaction is in progress。

✅ 正确解决方案:显式指定事务管理器名称

关键点在于:@Transactional(transactionManager = "xxx") 中的 xxx 是 Bean 的 ID(字符串名称),而非类类型。因此,以下写法是错误的:

// ❌ 错误:不能传入 Class 类型
@Transactional(transactionManager = MdmTxnManager.class)

而应使用配置中定义的 Bean 名称(即 XML 中 name 属性值):

// ✅ 正确:传入事务管理器 Bean 的 ID 字符串
@Transactional(transactionManager = "mdmTxnMang")
public void saveClientBiller(client_biller client_biller) {
    this.mdmTmp.saveOrUpdate(client_biller);
}

? 注意:确保 mdmTxnMang 是 中定义的精确 ID,并且该 Bean 已被 Spring 容器成功加载(可通过日志或 ApplicationContext.getBean("mdmTxnMang") 验证)。

? 补充建议:提升可维护性与类型安全

  1. 启用注解驱动事务(确认已在配置中声明):

    <annotation-driven transaction-manager="transactionManager"></annotation-driven>

    ⚠️ 注意:此配置仅设置默认事务管理器;多数据源场景下仍需在方法级显式指定 transactionManager 属性。

  2. 推荐改用 Java Config(Spring Boot 或现代 Spring),避免 XML 易错性:

    @Configuration
    @EnableTransactionManagement
    public class DataSourceConfig {
        @Bean(name = "mdmTransactionManager")
        public PlatformTransactionManager mdmTxManager(@Qualifier("mdmFactory") SessionFactory sessionFactory) {
            return new HibernateTransactionManager(sessionFactory);
        }
    }

    对应注解即可简洁书写:

    @Transactional("mdmTransactionManager")
    public void saveClientBiller(client_biller entity) { ... }
  3. 事务传播行为与隔离级别(按需增强):

    @Transactional(
        transactionManager = "mdmTxnMang",
        propagation = Propagation.REQUIRED,
        rollbackFor = Exception.class
    )
    public void saveClientBiller(client_biller client_biller) {
        this.mdmTmp.saveOrUpdate(client_biller);
    }

? 常见误区排查清单

  • [ ] 是否导入了正确的 @Transactional:org.springframework.transaction.annotation.Transactional(非 JPA 或 EJB 的同名注解)?
  • [ ] mdmTxnMang Bean 是否在 Spring 上下文中存在且无初始化异常?
  • [ ] mdmTmp(HibernateTemplate)是否确实注入了 mdmFactory?可加日志验证 mdmTmp.getSessionFactory() 输出。
  • [ ] 方法是否被 Spring 代理调用?非 Spring 管理对象直接调用(如 this.saveClientBiller())将绕过事务代理,导致注解失效。

✅ 总结

多数据源事务的核心原则是:每个写操作必须绑定到其对应数据源的事务管理器。@Transactional 不具备自动路由能力,必须通过 transactionManager 属性显式指定 Bean 名称(字符串)。同时,确保事务管理器、SessionFactory、DataSource 三者链路完整且无配置遗漏,即可稳定支持跨数据源的读写操作。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11597

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8702

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7492

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1476

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3049

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20291

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1335

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习