Spring自定义CrudRepository接口@Autowired注入失败原因排查

你遇到的核心问题是Spring无法自动创建DanCorePrivateRepository的Bean实例，导致@Autowired注入失败。这在Spring Data JPA的使用中属于高频问题，本质原因是Spring没有识别到你的Repository接口，无法为它生成代理对象。下面是几个最可能的原因和对应的解决步骤：

1. Spring未扫描到你的Repository接口 #

这是最常见的诱因！默认情况下，Spring Boot的@SpringBootApplication注解只会扫描启动类所在包及其子包下的所有组件（包括Repository、Controller、Service等）。如果你的DanCorePrivateRepository所在的com.sgcorp.repository包，和Spring Boot启动类所在的包不在同一个父包层级下，Spring就找不到这个Repository接口。

解决办法： #

• 方法一：把Spring Boot启动类移到com.sgcorp包下（也就是Repository所在包的父包），这样默认扫描规则就能覆盖到com.sgcorp.repository。
• 方法二：在启动类上添加@EnableJpaRepositories注解，明确指定Repository所在的包路径：

@SpringBootApplication
@EnableJpaRepositories(basePackages = "com.sgcorp.repository")
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 缺少Spring Data JPA依赖 #

如果项目里没有正确引入Spring Data JPA的依赖，Spring就不会自动为Repository接口生成代理Bean。

解决办法： #

检查你的依赖配置文件是否包含Spring Data JPA启动器：

• Maven（pom.xml）：

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

• Gradle（build.gradle）：

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

3. 实体类DanaModel未正确配置JPA注解 #

Spring Data JPA要求实体类符合JPA规范，否则无法为Repository生成代理。要确保DanaModel类上有@Entity注解，且主键字段带有@Id注解：

@Entity
public class DanaModel {
    @Id
    private String id; // 类型要和Repository泛型<String>匹配
    // 其他字段、getter/setter方法
}

4. Repository接口的泛型参数错误 #

检查DanCorePrivateRepository的泛型参数CrudRepository<DanaModel, String>是否正确：确保DanaModel是合法的JPA实体类，且主键类型确实为String（和实体类中@Id字段的类型一致）。泛型不匹配会导致Spring无法生成有效的代理Bean。

你可以先从第一个原因开始排查——这也是你之前项目能正常工作、当前项目出问题的大概率原因：之前的项目包结构符合默认扫描规则，而当前项目的包层级不在Spring的默认扫描范围内。

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