Spring Boot启动报错：Controller中找不到Repository类型Bean

1. 检查Repository接口的继承关系 #

确保StoreCardRepository正确继承Spring Data提供的Repository接口（如JpaRepository/CrudRepository），示例代码：

import org.springframework.data.jpa.repository.JpaRepository;
import example.storecard.StoreCard;

// 必须继承Spring Data的Repository接口，Spring才会自动生成代理Bean
public interface StoreCardRepository extends JpaRepository<StoreCard, Long> {
    // 自定义查询方法（可选）
}

未继承上述接口的话，Spring无法识别该类为Repository组件。

2. 确认主类的包扫描范围 #

Spring Boot默认扫描主类所在包及其子包的组件。如果你的主类不在example或其父包下，需在主类上添加@EnableJpaRepositories指定Repository所在包：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
// 指定Repository所在的包路径
@EnableJpaRepositories(basePackages = "example.storecard")
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

若使用MyBatis等其他框架，替换为@MapperScan注解指定对应包。

3. 检查依赖是否正确引入 #

如果用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'

缺失依赖会导致Spring无法自动创建Repository代理Bean。

4. 避免错误的注解标记 #

不要给StoreCardRepository接口添加@Component/@Service这类注解，Spring Data会自动处理Repository的Bean实例化，手动添加此类注解可能引发冲突。

5. 检查实体类配置 #

确保StoreCard实体类正确标记@Entity和主键注解：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;

@Entity // 标记为JPA实体类
public class StoreCard {
    @Id // 标记主键字段
    private Long id;
    // 其他字段、getter/setter
}

实体类配置错误会导致Spring Data无法关联对应的Repository。

6. 验证数据源配置 #

检查application.properties/application.yml中的数据源配置是否正确，示例：

spring.datasource.url=jdbc:mysql://localhost:3306/your_database
spring.datasource.username=db_user
spring.datasource.password=db_password
spring.jpa.hibernate.ddl-auto=update

数据源配置错误会导致Spring无法初始化Repository相关组件。

内容的提问来源于stack exchange，提问作者Raul C.