Spring Boot自定义仓储测试中Autowired注入Bean失败问题

@DataJpaTest是Spring Boot专为JPA仓储组件设计的测试注解，它默认只会扫描以下组件到测试上下文：

• 标注@Repository的类
• 继承Spring Data JPA Repository接口（如CrudRepository、JpaRepository）的接口
• JPA实体类（@Entity标注）

你的CustomContosoRepository标注的是@Service，不在默认扫描范围内，所以测试上下文无法找到该Bean，导致注入失败。

方案一：调整组件注解（推荐，符合语义） #

既然类的功能是仓储，直接将@Service替换为@Repository，同时通过@PersistenceContext注入EntityManager来执行原生HQL查询。这样既符合Spring组件的语义规范，又能被@DataJpaTest自动扫描。

示例代码：

@Repository
public class CustomContosoRepository implements CustomContosoService {
    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public List<ContosoEntity> executeCustomHql() {
        String hql = "SELECT c FROM ContosoEntity c WHERE c.isActive = true";
        return entityManager.createQuery(hql, ContosoEntity.class)
                .getResultList();
    }
}

测试类无需修改，@DataJpaTest会自动识别并注入该Bean。

方案二：在测试类中手动引入目标Bean #

如果因特殊原因无法修改组件注解，可以在测试类上添加@Import注解，直接指定要加载的CustomContosoRepository类，强制将其纳入测试上下文：

@DataJpaTest
@Import(CustomContosoRepository.class)
class CustomContosoRepositoryTest {
    @Autowired
    private CustomContosoRepository customContosoRepository;

    // 测试逻辑
    @Test
    void testCustomHqlQuery() {
        // 执行测试
    }
}

或者通过@ComponentScan指定类所在包（范围更广，不推荐精准测试场景）：

@DataJpaTest
@ComponentScan(basePackages = "com.nz.contoso.repository")
class CustomContosoRepositoryTest {
    @Autowired
    private CustomContosoRepository customContosoRepository;
}

方案三：改用全集成测试注解 #

如果测试需要依赖更多Spring Boot组件（不仅仅是JPA相关），可以用@SpringBootTest替代@DataJpaTest，它会加载完整的Spring应用上下文，自然能扫描到@Service标注的类。配合@Testcontainers配置测试容器即可：

@SpringBootTest
@Testcontainers
class CustomContosoRepositoryTest {
    @Container
    private static PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:15");

    @DynamicPropertySource
    static void setDatabaseProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", postgresContainer::getJdbcUrl);
        registry.add("spring.datasource.username", postgresContainer::getUsername);
        registry.add("spring.datasource.password", postgresContainer::getPassword);
    }

    @Autowired
    private CustomContosoRepository customContosoRepository;

    // 测试逻辑
}

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