Spring Boot中@Autowired注入失败：找不到CandidateRepository Bean

错误信息 #

---

APPLICATION FAILED TO START

---

Description:

Field candidateRepository in io.xgeek.interviewercalendarapi.service.CandidateServiceImpl required a bean of type 'io.xgeek.interviewercalendarapi.repository.CandidateRepository' that could not be found.

The injection point has the following annotations:
- @org.springframework.beans.factory.annotation.Autowired(required=true)

Action:

Consider defining a bean named 'entityManagerFactory' in your configuration.

排查与解决方案 #

1. 检查Candidate实体类是否添加@Entity注解 #

JPA要求实体类必须通过@Entity标记才能被框架识别，否则Spring Data JPA无法为Repository生成代理实现类。确保你的Candidate类配置如下：

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import lombok.Data;

@Entity
@Data
public class Candidate {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他业务字段
}

2. 补充H2数据库配置 #

虽然引入了H2依赖，但缺少数据源配置会导致Spring Boot无法自动创建entityManagerFactory。在src/main/resources/application.properties中添加以下配置：

# H2内存数据库配置
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

# 可选：启用H2控制台方便调试
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console

# JPA核心配置
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.H2Dialect

3. 显式指定JPA Repository扫描范围 #

虽然你的Repository位于主类的子包下，可显式配置扫描范围确保Spring能识别到Repository接口，修改主类：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
@EnableJpaRepositories(basePackages = "io.xgeek.interviewercalendarapi.repository")
public class InterviewerCalendarApiApplication {

   public static void main(String[] args) {
      SpringApplication.run(InterviewerCalendarApiApplication.class, args);
   }

}

4. 统一Spring Boot依赖版本 #

避免手动指定依赖版本导致的兼容性问题，在pom.xml中添加Spring Boot父依赖来统一管理版本：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <!-- 使用最新稳定版，例如3.2.x -->
    <version>3.2.0</version>
    <relativePath/>
</parent>

5. 清理项目缓存并重新构建 #

IDE缓存或编译残留可能导致bean无法被识别，执行以下操作：

• 执行mvn clean install（Gradle项目用clean build）
• 重启IDE并清除缓存（如IntelliJ IDEA：File -> Invalidate Caches...）

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