Spring Boot应用无法找到UsuarioRepository Bean问题求助

启动使用JpaRepository连接H2数据库的Spring Boot应用时，出现如下错误：

Field usuarioRepository in com.julio.demo.DemoApplication required a bean of type 'com.julio.repositories.UsuarioRepository' that could not be found.

注入点注解信息：

- @org.springframework.beans.factory.annotation.Autowired(required=true)

系统提示建议：

Consider defining a bean of type 'com.julio.repositories.UsuarioRepository' in your configuration.

我已尝试按提示配置，但仍报错，想确认@Repository配置是否正确，以下是我的相关代码与配置：

启动类代码 #

package com.julio.demo;

import java.util.Arrays;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

import com.julio.domain.Usuario;
import com.julio.repositories.UsuarioRepository;

@EnableJpaRepositories
@SpringBootApplication
public class DemoApplication implements CommandLineRunner {

    @Autowired
    private UsuarioRepository usuarioRepository;

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

    @Override
    public void run(String... args) throws Exception {
        Usuario u1 = new Usuario(null, "julio", "julio", "123");
        Usuario u2 = new Usuario(null, "cesar", "cesar", "123");

        usuarioRepository.saveAll(Arrays.asList(u1,u2));
    }

}

Repository接口代码 #

package com.julio.repositories;

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

import com.julio.domain.Usuario;

@Repository
public interface UsuarioRepository extends JpaRepository<Usuario, Integer>{

}

application.properties配置 #

spring.h2.console.enabled=true
spring.h2.console.path=/h2-console
spring.datasource.url=jdbc:h2:file:~/test
spring.datasource.username=sa
spring.datasource.password=
spring.datasource.driver-class-name=org.h2.Driver
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=create
spring.jpa.properties.hibernate.format_sql=true

Maven依赖配置（pom.xml） #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.3</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.julio</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>21</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-validation</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

解决方案 #

你的@Repository配置本身是正确的，问题出在@EnableJpaRepositories的扫描路径设置上：

1. 指定Repository扫描路径
   当前仅添加@EnableJpaRepositories注解，但未明确指定扫描包路径。Spring Boot默认从启动类所在包（com.julio.demo）及其子包扫描Bean，而UsuarioRepository在同级的com.julio.repositories包下，无法被自动扫描到。

   修改启动类的注解，添加basePackages参数指定Repository所在包：

   @EnableJpaRepositories(basePackages = "com.julio.repositories")
   @SpringBootApplication
   public class DemoApplication implements CommandLineRunner {
       // ... 原有代码
   }
   

2. 或者调整包结构
   将com.julio.repositories包移动到com.julio.demo包下，使其成为启动类所在包的子包，Spring Boot自动扫描机制就能找到它，无需额外配置扫描路径。

3. 验证依赖与注解

   • 依赖中已包含spring-boot-starter-data-jpa，满足JpaRepository生效的必要条件，无需修改。
   • UsuarioRepository上的@Repository注解可以省略，Spring Data JPA会自动为继承JpaRepository的接口生成代理Bean，保留注解也不会有问题。

完成上述修改后重新启动应用，Spring即可正确识别并创建UsuarioRepository的Bean，注入错误即可解决。

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