如何配置Spring Boot 2.X对接两个MySQL数据库并解决关联查询异常？

嘿，我在处理Spring Boot多数据源+Hibernate的场景时碰过好多次这类问题，结合你的描述——主库Foo的关联查询正常，次级库Bar的@OneToMany集合查询抛异常，交换主从后Bar又能正常工作，大概率是次级库的Hibernate上下文配置没跟上关联关系的处理，咱们一步步来排查解决：

1. 确保次级库的实体扫描覆盖所有关联实体 #

每个数据源都需要独立的实体扫描配置，一定要保证Bar库对应的主实体和@OneToMany关联的子实体都被包含在次级库的扫描路径里。如果你的主实体和子实体不在同一个包下，必须把两个包都加到配置中：

@Configuration
@EnableTransactionManagement
@EnableJpaRepositories(
    basePackages = "com.yourproject.bar.repository", // Bar库的DAO层路径
    entityManagerFactoryRef = "barEntityManagerFactory",
    transactionManagerRef = "barTransactionManager"
)
public class BarDataSourceConfig {

    @Bean
    @ConfigurationProperties(prefix = "spring.datasource.bar")
    public DataSource barDataSource() {
        return DataSourceBuilder.create().build();
    }

    @Bean
    public LocalContainerEntityManagerFactoryBean barEntityManagerFactory(
            EntityManagerFactoryBuilder builder, @Qualifier("barDataSource") DataSource dataSource) {
        return builder
                .dataSource(dataSource)
                .packages("com.yourproject.bar.entity", "com.yourproject.bar.childentity") // 包含所有关联实体的包
                .persistenceUnit("barPU") // 唯一的持久化单元名称
                .build();
    }

    @Bean
    public PlatformTransactionManager barTransactionManager(
            @Qualifier("barEntityManagerFactory") EntityManagerFactory entityManagerFactory) {
        return new JpaTransactionManager(entityManagerFactory);
    }
}

如果漏掉了子实体的包，Hibernate在次级库的SessionFactory里找不到子实体的元数据，关联查询时必然会抛出异常。

2. 给次级库的查询方法绑定专属事务管理器 #

默认情况下，Spring会使用主库的事务管理器，如果你查询Bar库的方法没有明确指定事务管理器，就会出现跨数据源的会话冲突，尤其是@OneToMany默认是懒加载，必须在对应数据源的事务上下文里才能初始化集合。

在你的REST Controller方法上明确指定Bar库的事务管理器：

@RestController
@RequestMapping("/bar-entities")
public class BarEntityController {

    @Autowired
    private BarEntityRepository barRepo;

    @GetMapping("/all")
    @Transactional(value = "barTransactionManager") // 绑定次级库的事务管理器
    public List<BarEntity> getAllBarEntities() {
        return barRepo.findAll();
    }
}

这样查询操作会完全在Bar库的事务上下文中执行，懒加载的集合也能正常初始化。

3. 确认关联实体都属于同一个数据源 #

Hibernate的SessionFactory是数据源隔离的，绝对不能跨数据源关联实体——也就是说Bar库的实体不能关联Foo库的实体，反之亦然。虽然你交换主从后Bar正常，大概率不是这个问题，但还是要检查下@OneToMany关联的子实体是不是确实属于Bar库的数据源。

4. 独立配置次级库的JPA属性 #

确保次级库的Hibernate配置是独立的，不要和主库共用一套配置。在application.properties或application.yml里单独配置Bar库的JPA属性：

# 主库Foo配置
spring.datasource.foo.url=jdbc:mysql://foo-server:3306/foo_db
spring.datasource.foo.username=foo_user
spring.datasource.foo.password=foo_pass

# 次级库Bar配置
spring.datasource.bar.url=jdbc:mysql://bar-server:3306/bar_db
spring.datasource.bar.username=bar_user
spring.datasource.bar.password=bar_pass

# 主库JPA配置
spring.jpa.foo.hibernate.ddl-auto=none
spring.jpa.foo.show-sql=true
spring.jpa.foo.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect

# 次级库JPA配置
spring.jpa.bar.hibernate.ddl-auto=none
spring.jpa.bar.show-sql=true
spring.jpa.bar.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect

这样次级库的Hibernate会使用自己的方言、SQL展示等配置，避免和主库的配置冲突。

5. 排查懒加载的特殊情况 #

如果上面的配置都没问题，但还是抛出LazyInitializationException，可以临时添加次级库的懒加载允许配置（不推荐长期使用，最好还是用事务包裹查询）：

spring.jpa.bar.properties.hibernate.enable_lazy_load_no_trans=true

按照上面的步骤排查下来，基本就能解决次级库@OneToMany关联查询的异常问题。核心原则就是每个数据源的SessionFactory、事务管理器、实体扫描必须完全独立，查询操作要在对应数据源的事务上下文里执行，关联的实体都要属于同一个数据源的扫描范围。

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