SpringBoot JUnit测试原生查询时出现NoSuchBeanDefinitionException问题

可能原因及对应解决方案 #

1. Spring未扫描到Repository接口 #

Spring Boot默认仅扫描主应用类（标注@SpringBootApplication的类）所在包及其子包下的组件。如果DocumentRepositoryTest所在包不在这个范围内，Spring无法识别并生成代理Bean。

解决方法：

• 将DocumentRepositoryTest移动到主应用类的子包下；
• 或在主应用类上添加@EnableJpaRepositories注解，指定Repository所在的包路径：

  @SpringBootApplication
  @EnableJpaRepositories(basePackages = "com.yourproject.repository") // 替换为实际包路径
  public class YourApplication {
      public static void main(String[] args) {
          SpringApplication.run(YourApplication.class, args);
      }
  }
  

2. 父接口DocumentRepository未正确继承Spring Data基础Repository #

Spring Data JPA仅会为继承了JpaRepository、CrudRepository等基础Repository接口的子接口生成代理Bean。如果DocumentRepository没有继承这些接口，DocumentRepositoryTest也无法被识别为Repository组件。

解决方法：
确保DocumentRepository继承正确的基础接口，例如：

@Repository
public interface DocumentRepository extends JpaRepository<Document, Integer> {
    // 父接口方法
}

3. 原生SQL语法错误（提前规避后续执行问题） #

你的查询语句中FROM document d与WHERE d.id = :id之间缺少空格，拼接后会变成document dWHERE，属于语法错误。虽不会直接导致Bean定义缺失，但会在测试执行时抛出SQL异常，建议提前修正：

@Query("SELECT * " +
        "FROM document d " + // 此处添加空格
        "WHERE d.id = :id")
Object runQuery(@NonNull Integer id);

4. 测试类未正确加载Spring上下文 #

如果测试类DocumentServiceTest所在包与主应用类包层级无关，或未指定加载的主应用类，可能导致上下文未正确初始化，无法扫描到Repository。

解决方法：
在@SpringBootTest注解中明确指定主应用类：

@SpringBootTest(classes = YourApplication.class) // 替换为你的主应用类
public class DocumentServiceTest {
    // 测试代码
}

5. 缺失Spring Data JPA依赖 #

如果项目中没有引入spring-boot-starter-data-jpa依赖，Spring Data JPA的自动配置不会生效，无法生成Repository代理Bean。

解决方法：
检查pom.xml（Maven）或build.gradle（Gradle）是否包含该依赖：

• 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'
  

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