Spring Boot构造器注入报错：找不到PageRepository Bean

问题描述 #

我跟着教程开发Spring Boot应用，完全按教程操作，但遇到构造器注入相关问题。报错信息：com.wewtorek.shop.controllers.AdminController的构造器第0个参数需要类型为com.wewtorek.shop.models.data.PageRepository的Bean，但找不到该Bean。

相关代码如下：

AdminController代码

package com.wewtorek.shop.controllers;
import com.wewtorek.shop.models.data.Page;
import com.wewtorek.shop.models.data.PageRepository;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;

import java.util.List;

@Controller
@RequestMapping("/admin")
public class AdminController {

    private PageRepository pageRepository;


    public AdminController(PageRepository pageRepository) {
        this.pageRepository = pageRepository;
    }

    @GetMapping
    public String admin(Model model) {

        List<Page> pages = pageRepository.findAll();

        model.addAttribute("pages", pages);

        return "admin";
    }
}

PageRepository代码

package com.wewtorek.shop.models.data;

import org.springframework.data.jpa.repository.JpaRepository;

public interface PageRepository extends JpaRepository<Page, Integer> {
}

ShopApplication代码

package com.wewtorek.shop;

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

@SpringBootApplication
public class ShopApplication {

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

}

解决办法 #

• 检查Page实体类的JPA注解
  PageRepository基于JpaRepository实现，对应的Page实体类必须标注@Entity注解，同时配置主键（如@Id、@GeneratedValue）。如果实体类未被Spring Data JPA识别，Repository接口无法被实例化为Bean。示例：

  package com.wewtorek.shop.models.data;
  
  import jakarta.persistence.Entity;
  import jakarta.persistence.GeneratedValue;
  import jakarta.persistence.GenerationType;
  import jakarta.persistence.Id;
  
  @Entity
  public class Page {
      @Id
      @GeneratedValue(strategy = GenerationType.IDENTITY)
      private Integer id;
      // 其他字段、getter、setter方法
  }
  

• 确认Spring Data JPA依赖已引入
  检查你的pom.xml（Maven）或build.gradle（Gradle）是否包含Spring Data JPA启动依赖：
  Maven配置：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
  

  Gradle配置：

  implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
  

  缺少该依赖会导致Spring无法自动创建Repository的Bean实例。

• 验证数据库配置正确性
  检查application.properties或application.yml中的数据库连接配置是否有效，示例：

  spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name
  spring.datasource.username=your_db_username
  spring.datasource.password=your_db_password
  spring.jpa.hibernate.ddl-auto=update
  

  数据源配置错误会导致Spring Data JPA无法初始化，进而无法生成Repository Bean。

• 强制指定Repository扫描范围（可选）
  若上述步骤都正常但问题仍存在，可在启动类上添加@EnableJpaRepositories注解，明确指定Repository所在包：

  package com.wewtorek.shop;
  
  import org.springframework.boot.SpringApplication;
  import org.springframework.boot.autoconfigure.SpringBootApplication;
  import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
  
  @SpringBootApplication
  @EnableJpaRepositories(basePackages = "com.wewtorek.shop.models.data")
  public class ShopApplication {
      public static void main(String[] args) {
          SpringApplication.run(ShopApplication.class, args);
      }
  }
  

  注：默认情况下@SpringBootApplication会扫描启动类所在包及其子包，此步骤仅针对特殊包结构场景。

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