Spring单元测试用@DataJpaTest时出现UnsatisfiedDependencyException求助

错误核心原因 #

报错信息明确指出：Failed to replace DataSource with an embedded database for tests，这是因为@DataJpaTest注解默认会尝试用嵌入式数据库替换生产环境的数据源，但你的项目满足以下两种情况之一：

1. 没有引入任何嵌入式数据库的测试依赖；
2. 配置了非嵌入式数据源，但未禁用自动替换逻辑。

解决方案 #

方案1：添加嵌入式数据库依赖

在项目的构建文件中加入H2、HSQLDB或Derby这类轻量嵌入式数据库的测试依赖，Spring Boot会自动完成配置。

Maven（pom.xml）：

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

Gradle（build.gradle）：

testImplementation 'com.h2database:h2'

方案2：禁用数据源自动替换

如果想直接使用和生产环境一致的数据库（如MySQL、PostgreSQL），只需在测试类上添加@AutoConfigureTestDatabase注解，关闭数据源替换逻辑：

@DataJpaTest
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
class DepartmentRepositoryTest {
    // 原有测试代码保持不变
}

同时要确保application-test.properties或application-test.yml中配置了正确的测试数据库连接信息。

额外提示 #

• Spring Boot 2.2及以上版本中，@DataJpaTest会自动检测classpath中的嵌入式数据库依赖，无需手动配置数据源；
• 如果项目中有自定义的DataSource配置类，需确保它不会干扰测试环境的自动配置逻辑。

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