SpringBoot JPA应用启动报错：无法找到Repository类型的Bean

我用Java 8编写了一个基础SpringBoot Web应用，用于读取名为Tmsdata表中的数据，相关代码如下：

SyncApplication.java #

@SpringBootApplication
public class SyncApplication {

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

SyncController.java #

@Controller
public class SyncController {

  @Autowired
  private TmsdataService tmsdataService;


  @GetMapping("/")
  @ResponseBody
  public String default() {

    List<Tmsdata> a = tmsdataService.findAll();

    return "{ message: 'OK', count: " + a.size() + " }";
  }

}

TmsdataRepository.java #

@Repository
public interface TmsdataRepository extends JpaRepository<Tmsdata, Long> {
    // Define custom query methods if needed

}

TmsdataService.java #

@Service
public class TmsdataService {

  @Autowired
  private TmsdataRepository tmsdataRepository;

  public List<Tmsdata> findAll() {

    List<Tmsdata> a = tmsdataRepository.findAll();

    return a;
  }

}

Tmsdata.java #

public class Tmsdata {
  @Id
  private Long record_id;
}

项目编译无问题，但执行mvn spring-boot:run时出现如下报错：

***************************
APPLICATION FAILED TO START
***************************
Description:
Field tmsdataRepository in com.company.sync.TmsdataService required a bean of type 'com.company.sync.TmsdataRepository' 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.company.sync.TmsdataRepository' in your configuration.

我已定义了该JPA Repository，请问还可能是什么原因导致此问题？

以下是几种常见的导致JPA Repository无法被Spring识别并创建Bean的原因：

• 缺少JPA启动依赖
  检查pom.xml是否引入Spring Data JPA的starter依赖，没有的话Spring无法自动配置JPA扫描机制，需添加：

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

• Repository不在Spring扫描范围内
  @SpringBootApplication默认只扫描自身所在包及子包的组件，若TmsdataRepository不在这个范围内，Spring无法发现它。
  解决方案：要么调整包结构让Repository处于启动类的包/子包下；要么在SyncApplication上添加@EnableJpaRepositories指定Repository所在包：

  @SpringBootApplication
  @EnableJpaRepositories(basePackages = "com.company.sync")
  public class SyncApplication {
      // ...
  }
  

• 实体类缺少JPA核心注解
  你的Tmsdata仅加了@Id注解，缺少@Entity注解，Spring Data JPA无法识别这是JPA实体类，进而影响Repository的Bean创建。需补充注解：

  @Entity
  @Table(name = "Tmsdata") // 表名与类名不一致时需指定
  public class Tmsdata {
    @Id
    private Long record_id;
    // ... 其他字段及getter/setter
  }
  

• Spring Boot与Java版本不兼容
  若使用Spring Boot 3.x版本，它要求Java 17+，和你用的Java 8不兼容会导致JPA组件无法正常工作。需改用支持Java 8的Spring Boot 2.x系列（推荐2.7.x稳定分支）。

• Repository泛型或实体类定义问题
  检查Tmsdata的ID类型Long是否与数据库中record_id类型一致，同时实体类建议实现Serializable接口：

  @Entity
  public class Tmsdata implements Serializable {
    @Id
    private Long record_id;
    // ...
  }
  

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