Spring Boot项目启动报错：无法找到PostRepository类型的Bean

问题场景 #

开发包含博客文章CRUD操作的Spring Boot MVC应用时，启动报错，提示BlogController中的postRepository字段需要com.example.demo.repo.PostRepository类型的Bean，但无法找到。

错误日志 #

Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
2023-03-01 14:47:48.697 ERROR 4176 --- [  restartedMain] o.s.b.d.LoggingFailureAnalysisReporter   : 

***************************
APPLICATION FAILED TO START
***************************

Description:

Field postRepository in com.example.demo.controllers.BlogController required a bean of type 'com.example.demo.repo.PostRepository' 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 of type 'com.example.demo.repo.PostRepository' in your configuration.


Process finished with exit code 1

相关代码 #

Controller代码（BlogController.java） #

package com.example.demo.controllers;

import com.example.demo.models.Post;
import com.example.demo.repo.PostRepository;
import javafx.geometry.Pos;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartException;

import java.util.ArrayList;
import java.util.Optional;

@Controller
public class BlogController {

    @Autowired
    private PostRepository postRepository;

    @GetMapping("/blog")
    public String name(Model model, String name) {
        Iterable<Post> posts = postRepository.findAll();
        model.addAttribute("posts", posts);
        return "blogmain";
    }
}

Repository代码（PostRepository.java） #

package com.example.demo.repo;

import com.example.demo.models.Post;
import org.springframework.data.repository.CrudRepository;

public interface PostRepository extends CrudRepository<Post, Long> {}

启动类代码（DemoApplication.java） #

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;
import org.springframework.context.annotation.ComponentScan;

@SpringBootApplication(exclude={DataSourceAutoConfiguration.class})
@ComponentScan(basePackages = "com.example.demo")
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

项目结构 #

src/main/java/com/example/demo
|_controllers
  |_BlogController.java
  |_MainController.java
|_models
  |_[...]
|_repo
  |_PostRepository.java
|_templates
  |_[...]
|_DemoApplication.java

解决方案 #

1. 修改启动类配置，移除数据源自动配置排除 #

Spring Data JPA的Repository Bean创建依赖数据源上下文，你排除了DataSourceAutoConfiguration导致无法初始化必要的Bean。修改启动类代码如下：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

说明：@SpringBootApplication注解已经包含了@ComponentScan（默认扫描当前包及其子包），所以不需要额外添加@ComponentScan注解。

2. 确保依赖齐全 #

检查项目依赖配置（如pom.xml或build.gradle），确保包含Spring Data JPA和数据库驱动依赖。示例pom.xml依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<!-- 以H2内存数据库为例，可根据实际数据库替换 -->
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

3. 验证Repository扫描范围 #

你的PostRepository位于com.example.demo.repo包下，启动类在com.example.demo包下，@SpringBootApplication默认会扫描当前包及其所有子包，因此Repository会被自动识别，无需额外配置扫描路径。

原因分析 #

排除DataSourceAutoConfiguration后，Spring无法初始化数据源相关的上下文环境，而Spring Data JPA需要基于数据源来生成Repository的实现Bean，因此即使Repository接口定义正确，也无法创建对应的Bean实例，导致注入失败。

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