升级Spring Boot3后服务器启动失败：找不到NewsRepository Bean

问题描述 #

升级Spring Boot3后启动服务器失败，抛出org.springframework.beans.factory.NoSuchBeanDefinitionException异常，核心提示：

不存在符合条件的com.sample.fa.repository.NewsRepository类型Bean，至少需要1个可作为自动注入候选的Bean。
详细说明：com.sample.fa.service.NewsService中的newsRepository字段需要的com.sample.fa.repository.NewsRepository类型Bean未找到，注入点标注了@Autowired(required=true)。

涉及Repository代码：

@Repository
public interface NewsRepository extends JpaRepository<News, Long> {
    Optional<News> findById(Long id);
}

排查与解决步骤 #

1. 检查启动类的包扫描范围 #

Spring Boot3默认扫描启动类所在包及其子包的组件。如果启动类的包路径比com.sample.fa更深（比如com.sample.fa.application），则com.sample.fa.repository不在默认扫描范围内，需要手动指定扫描路径：

• 在启动类上添加scanBasePackages参数：

  @SpringBootApplication(scanBasePackages = "com.sample.fa")
  public class Application {
      public static void main(String[] args) {
          SpringApplication.run(Application.class, args);
      }
  }
  

• 或者单独指定JPA Repository的扫描路径：

  @EnableJpaRepositories(basePackages = "com.sample.fa.repository")
  @SpringBootApplication
  public class Application { ... }
  

2. 确认Spring Data JPA依赖正确引入 #

Spring Boot3对应Spring Data JPA 3.x版本，确保依赖配置正确：

• Maven（pom.xml）：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
  <!-- 数据库驱动示例（MySQL） -->
  <dependency>
      <groupId>com.mysql</groupId>
      <artifactId>mysql-connector-j</artifactId>
      <scope>runtime</scope>
  </dependency>
  

• Gradle（build.gradle）：

  implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
  runtimeOnly 'com.mysql:mysql-connector-j'
  

3. 验证实体类News的注解配置 #

JPA Repository生成Bean的前提是对应实体类被正确识别，确认News类满足：

• 标注@Entity注解
• 主键字段标注@Id（可选配合@GeneratedValue指定生成策略）
  示例：

@Entity
public class News {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他字段、getter/setter
}

4. 检查是否禁用了JPA自动配置 #

如果启动类或配置中存在@SpringBootApplication(exclude = JpaAutoConfiguration.class)，会导致Spring Boot自动配置JPA的逻辑失效，需移除该exclude配置，或手动配置JPA相关Bean。

5. 确认Java版本符合要求 #

Spring Boot3强制要求Java 17及以上，检查项目的编译环境（IDE设置、pom.xml/gradle的sourceCompatibility）和运行环境是否为Java 17，低版本Java会导致Spring Boot3的自动配置逻辑异常。

验证方法 #

启动项目前，查看启动日志，若出现类似Found repository interfaces: com.sample.fa.repository.NewsRepository的日志，说明Repository Bean已被成功扫描并创建；若未出现，需重新排查上述步骤。

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