如何解决No bean named 'dataSource' available问题及成因排查

核心问题定位 #

1. @Value注解赋值完全颠倒 #

代码里@Value的变量赋值搞反了，这是数据源初始化失败的直接原因：

@Value("org.h2.Driver")
private String dbUrl; // 错误：把驱动类赋值给了URL变量

@Value("jdbc:h2:mem:test")
private String dbDriverClass; // 错误：把URL赋值给了驱动类变量

正确写法应该是：

@Value("org.h2.Driver")
private String dbDriverClass;

@Value("jdbc:h2:mem:test")
private String dbUrl;

更合理的方式是直接读取配置文件中的配置，避免硬编码：

@Value("${spring.datasource.driverClassName}")
private String dbDriverClass;

@Value("${spring.datasource.url}")
private String dbUrl;

@Value("${spring.datasource.username}")
private String dbUser;

@Value("${spring.datasource.password}")
private String dbPassword;

2. EntityManagerFactory未通过Spring注入DataSource #

entityManagerFactory()方法里直接调用dataSource()创建实例，这会绕过Spring的Bean管理机制，生成一个不受容器管控的数据源对象。同时容器中本该存在的dataSource Bean可能因前面的错误未初始化，最终触发NoSuchBeanDefinitionException。

正确做法是通过方法参数注入（推荐）或字段注入获取Spring管理的DataSource：

@Bean
public LocalContainerEntityManagerFactoryBean entityManagerFactory(DataSource dataSource) throws Exception {
    LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
    em.setDataSource(dataSource); // 使用容器注入的DataSource Bean
    em.setPackagesToScan(new String[]{"xx.xxx.xxxx"});
    em.setJpaVendorAdapter(new HibernateJpaVendorAdapter());
    em.setJpaProperties(additionalProperties());
    return em;
}

3. @ConditionalOnMissingBean导致自定义DataSource未被创建 #

你在dataSource()方法上添加了@ConditionalOnMissingBean注解，而Spring Boot会根据application-localtest.properties里的spring.datasource.*配置自动生成一个DataSource Bean。这会触发注解逻辑：因为已有同类型Bean存在，自定义的DataSource Bean被跳过创建。容器中存在的是自动配置的数据源，但你的代码逻辑并未正确使用它。

如果要强制使用自定义DataSource，可选择：

• 移除@ConditionalOnMissingBean注解
• 禁用Spring Boot的自动数据源配置，在测试启动类添加@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)

其他排查方向 #

1. 确认H2依赖存在 #

检查pom.xml（Maven）或build.gradle（Gradle）中是否添加了H2依赖：
Maven：

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>test</scope>
</dependency>

Gradle：

testImplementation 'com.h2database:h2'

2. 检查SQL脚本路径 #

确认/test/data/Create_Tables.sql存在于类路径中，路径错误会导致ResourceDatabasePopulator.execute()失败，进而中断数据源初始化。

3. 验证配置文件生效 #

查看启动日志是否输出The following profiles are active: localtest，确认localtest配置已激活，且@TestPropertySource加载的配置文件路径正确。

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