Spring Data JDBC初始化Repository bean失败 自定义数据源下自动配置失效如何解决

根因说明 #

你遇到的No qualifying bean of type 'org.springframework.data.relational.core.mapping.RelationalMappingContext'报错，核心原因是自定义多数据源后，Spring Data JDBC 的默认自动配置被触发条件拦截，不会自动初始化关系映射上下文、JdbcTemplate、Repository扫描器等必须组件，需要手动绑定每个数据源对应的相关配置。

步骤1：修复配置类属性绑定错误 #

你的现有配置中两个DataSourceProperties都绑定了同一个前缀datasource1.spring.datasource，第二个数据源的属性前缀需要修正：

// 原错误配置
@Bean(name = "DSProperties2")
@ConfigurationProperties("datasource1.spring.datasource")
public DataSourceProperties dataSourceProperties1() {
  return new DataSourceProperties();
}
// 修正后配置
@Bean(name = "DSProperties2")
@ConfigurationProperties("datasource2.spring.datasource")
public DataSourceProperties dataSourceProperties1() {
  return new DataSourceProperties();
}

步骤2：按数据源拆分Repository包 #

将不同数据源对应的Repository接口放在独立的包路径下，方便后续指定扫描范围：

• 数据源1对应Repository放在com.yourpackage.repository.ds1
• 数据源2对应Repository放在com.yourpackage.repository.ds2

步骤3：为每个数据源单独配置Spring Data JDBC组件 #

手动为每个数据源注册对应的JdbcTemplate、关系映射上下文、JDBC转换器，并且绑定对应的Repository扫描路径：

数据源1配置类示例 #

@Configuration
@EnableJdbcRepositories(
  basePackages = "com.yourpackage.repository.ds1",
  jdbcOperationsRef = "jdbcTemplate1"
)
public class Ds1JdbcConfiguration {

  @Bean("jdbcTemplate1")
  @Primary
  public JdbcTemplate jdbcTemplate1(@Qualifier("DataSource1") DataSource dataSource) {
    return new JdbcTemplate(dataSource);
  }

  @Bean
  @Primary
  public RelationalMappingContext relationalMappingContext1() {
    return new RelationalMappingContext();
  }

  @Bean
  @Primary
  public JdbcConverter jdbcConverter1(RelationalMappingContext mappingContext,
                                      @Qualifier("DataSource1") DataSource dataSource) {
    return new BasicJdbcConverter(mappingContext, new DefaultJdbcTypeFactory(dataSource));
  }
}

数据源2配置类示例 #

@Configuration
@EnableJdbcRepositories(
  basePackages = "com.yourpackage.repository.ds2",
  jdbcOperationsRef = "jdbcTemplate2"
)
public class Ds2JdbcConfiguration {

  @Bean("jdbcTemplate2")
  public JdbcTemplate jdbcTemplate2(@Qualifier("DataSource2") DataSource dataSource) {
    return new JdbcTemplate(dataSource);
  }

  @Bean
  public RelationalMappingContext relationalMappingContext2() {
    return new RelationalMappingContext();
  }

  @Bean
  public JdbcConverter jdbcConverter2(RelationalMappingContext mappingContext,
                                      @Qualifier("DataSource2") DataSource dataSource) {
    return new BasicJdbcConverter(mappingContext, new DefaultJdbcTypeFactory(dataSource));
  }
}

步骤4：排除冲突自动配置（可选） #

如果启动仍存在Bean冲突，可以在启动类上排除默认的数据源和JDBC自动配置：

@SpringBootApplication(exclude = {
  DataSourceAutoConfiguration.class,
  JdbcRepositoriesAutoConfiguration.class
})
public class YourApplication {
  public static void main(String[] args) {
    SpringApplication.run(YourApplication.class, args);
  }
}

关于实体类注解说明 #

你提到没有给DTO加@Table、@Column注解，只要实体类字段名与数据库表字段完全符合驼峰转下划线的默认映射规则，就不会影响功能运行，也不会导致本次报错；如果存在字段名不匹配的情况，补充对应注解即可。

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