Spring多数据源事务异常：指定写事务却使用读数据源求助

1. 检查Repository与数据源的绑定关系 #

• 确认EmployeeRepository是否正确关联到写数据源对应的EntityManagerFactory。如果Repository被错误绑定到只读数据源的EntityManagerFactory，即便指定了写事务管理器，依然会使用只读库。
• 排查方式：检查Repository所在包是否被写数据源的@EnableJpaRepositories扫描，且指定了对应的entityManagerFactoryRef和transactionManagerRef。示例配置：

  @EnableJpaRepositories(
      basePackages = "com.yourproject.repo.write",
      entityManagerFactoryRef = "writeEntityManagerFactory",
      transactionManagerRef = "writeTransactionManager"
  )
  

  若EmployeeRepository被包含在只读数据源的扫描包内，就会绑定错误的数据源。

2. 验证写事务管理器的配置正确性 #

• 确认writeTransactionManager是否关联到写数据源的EntityManagerFactory。检查配置代码：

  @Bean(name = "writeTransactionManager")
  public PlatformTransactionManager writeTransactionManager(
      @Qualifier("writeEntityManagerFactory") EntityManagerFactory emf) {
      return new JpaTransactionManager(emf);
  }
  

  确保@Qualifier指向的是写数据源对应的EntityManagerFactory，避免与只读实例混淆。

3. 排查@Transactional注解的优先级与生效情况 #

• 检查Service类或方法是否存在多个@Transactional注解冲突：比如类级别标注了只读事务管理器，方法级别的注解未正确覆盖，导致依然使用只读事务。
• 确认Service类已被Spring扫描：类上是否添加@Service或@Component注解，且所在包在Spring的扫描路径范围内。

4. 检查动态数据源路由逻辑（若有配置） #

• 如果使用了动态数据源路由（基于AOP或ThreadLocal实现），确认路由规则是否在事务开启前切换到写数据源。部分动态数据源实现会在事务开启后锁定数据源，若事务启动前未完成切换，会一直使用初始的只读数据源。
• 排查方式：在Service方法开头打印当前数据源标识，或在路由类中添加日志，查看实际路由结果。

5. 验证数据库实例的权限配置 #

• 确认写数据库实例确实拥有写入权限，避免配置时误将只读实例设为写数据源。可以直接用数据库客户端连接写实例，执行INSERT语句测试是否能正常写入。

6. 开启Spring事务日志排查 #

• 开启Spring事务和JPA的DEBUG日志，查看事务绑定细节。在配置文件中添加：

  logging:
    level:
      org.springframework.transaction: DEBUG
      org.springframework.orm.jpa: DEBUG
  

  从日志中可以明确看到事务开启时使用的事务管理器，以及对应的EntityManagerFactory是否正确。

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