为Spring项目添加第二数据源引发字段命名问题

嘿，我明白你遇到的问题了——之前单Oracle数据源的时候，Spring Boot的JPA自动帮你把实体的驼峰属性转成数据库的下划线字段，所以大部分字段根本不用写@Column(name = "xxx")，但加了MySQL双数据源后，突然就必须手动加这个注解才能正常映射了，对吧？

这事儿的根源其实很简单：双数据源配置时，每个数据源的JPA命名策略需要单独指定，不然默认的自动驼峰转下划线规则就失效了。下面给你一步步解决的方案：

1. 给每个数据源的JPA配置明确指定命名策略 #

你需要在Oracle和MySQL各自的数据源配置类里，显式设置Hibernate的命名策略，和之前单数据源时的规则保持一致。

MySQL数据源配置类示例 #

@Configuration
@EnableJpaRepositories(
        basePackages = "com.yourproject.mysql.repos", // 替换为你的MySQL仓库包路径
        entityManagerFactoryRef = "mysqlEntityManagerFactory",
        transactionManagerRef = "mysqlTransactionManager"
)
public class MysqlDataSourceConfig {

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

    @Bean
    public LocalContainerEntityManagerFactoryBean mysqlEntityManagerFactory(
            EntityManagerFactoryBuilder builder,
            @Qualifier("mysqlDataSource") DataSource dataSource) {
        Map<String, Object> jpaProperties = new HashMap<>();
        // 关键！指定和Oracle一样的下划线转驼峰命名策略
        jpaProperties.put("hibernate.physical_naming_strategy", 
                          "org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy");
        jpaProperties.put("hibernate.implicit_naming_strategy", 
                          "org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy");
        // 配置MySQL方言
        jpaProperties.put("hibernate.dialect", "org.hibernate.dialect.MySQL8Dialect");

        return builder
                .dataSource(dataSource)
                .packages("com.yourproject.mysql.entities") // 替换为你的MySQL实体类包路径
                .persistenceUnit("mysqlPU")
                .properties(jpaProperties)
                .build();
    }

    @Bean
    public PlatformTransactionManager mysqlTransactionManager(
            @Qualifier("mysqlEntityManagerFactory") EntityManagerFactory emf) {
        return new JpaTransactionManager(emf);
    }
}

Oracle数据源配置类示例 #

同样，Oracle的配置类也要加上相同的命名策略配置（如果之前没加的话）：

@Configuration
@EnableJpaRepositories(
        basePackages = "com.yourproject.oracle.repos", // 替换为你的Oracle仓库包路径
        entityManagerFactoryRef = "oracleEntityManagerFactory",
        transactionManagerRef = "oracleTransactionManager"
)
public class OracleDataSourceConfig {

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

    @Bean
    public LocalContainerEntityManagerFactoryBean oracleEntityManagerFactory(
            EntityManagerFactoryBuilder builder,
            @Qualifier("oracleDataSource") DataSource dataSource) {
        Map<String, Object> jpaProperties = new HashMap<>();
        jpaProperties.put("hibernate.physical_naming_strategy", 
                          "org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy");
        jpaProperties.put("hibernate.implicit_naming_strategy", 
                          "org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy");
        // 配置Oracle方言
        jpaProperties.put("hibernate.dialect", "org.hibernate.dialect.Oracle12cDialect");

        return builder
                .dataSource(dataSource)
                .packages("com.yourproject.oracle.entities") // 替换为你的Oracle实体类包路径
                .persistenceUnit("oraclePU")
                .properties(jpaProperties)
                .build();
    }

    @Bean
    public PlatformTransactionManager oracleTransactionManager(
            @Qualifier("oracleEntityManagerFactory") EntityManagerFactory emf) {
        return new JpaTransactionManager(emf);
    }
}

2. 检查全局配置，避免冲突 #

别在application.properties/yml里写全局的JPA命名策略配置（比如spring.jpa.hibernate.naming.physical-strategy），让每个数据源的配置类单独指定，不然会出现配置覆盖的问题。

举个application.yml的双数据源配置示例：

spring:
  datasource:
    oracle:
      url: jdbc:oracle:thin:@//your-oracle-host:1521/ORCL
      username: oracle_user
      password: oracle_pass
      driver-class-name: oracle.jdbc.OracleDriver
    mysql:
      url: jdbc:mysql://your-mysql-host:3306/your_db?useSSL=false&serverTimezone=UTC
      username: mysql_user
      password: mysql_pass
      driver-class-name: com.mysql.cj.jdbc.Driver

3. 测试验证 #

配置完之后，你可以把那些之前因为映射问题不得不加的@Column(name = "xxx")（除了少数字段名不符合驼峰转下划线规则的特殊情况）删掉，然后启动项目跑一下CRUD接口，确认字段映射正常工作。

为啥会出现这个问题？ #

简单说：单数据源时，Spring Boot会自动把全局的JPA配置（包括命名策略）应用到默认的EntityManagerFactory上。但当你手动配置双数据源时，每个自定义的EntityManagerFactory不会自动继承全局配置，Hibernate会用它自己的默认命名策略——这个策略不会做驼峰转下划线的转换，所以实体属性和数据库字段名称就对不上了，必须手动加@Column指定。

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