为何Micronaut在Serenity BDD测试中无法注入依赖？

报错信息 #

io.micronaut.context.exceptions.DependencyInjectionException: Failed to inject value for parameter [serviceEndpointProvider] of class: {path}.ApiClient

Message: No bean of type [{path}.ServiceEndpointProvider] exists. Make sure the bean is not disabled by bean requirements (enable trace logging for 'io.micronaut.context.condition' to check) and if the bean is enabled then ensure the class is declared a bean and annotation processing is enabled (for Java and Kotlin the 'micronaut-inject-java' dependency should be configured as an annotation processor).
Path Taken: new ApiClient(ServiceEndpointProvider serviceEndpointProvider) --> new ApiClient([ServiceEndpointProvider serviceEndpointProvider])

可能的原因及解决方法 #

1. ApiClient未被Micronaut容器管理 #

如果Serenity直接通过new ApiClient()手动创建实例，而非由Micronaut依赖注入容器提供，就会导致无法注入ServiceEndpointProvider。

• 检查点：确认ApiClient类是否添加了Micronaut的Bean注解（如@Singleton、@Prototype），且测试中获取ApiClient的方式是通过@Inject注入，而非手动实例化。
• 修复示例：

  @Singleton
  public class ApiClient {
      private final ServiceEndpointProvider serviceEndpointProvider;
  
      // 构造函数注入
      public ApiClient(ServiceEndpointProvider serviceEndpointProvider) {
          this.serviceEndpointProvider = serviceEndpointProvider;
      }
  }
  

  在测试类中注入ApiClient：

  @MicronautTest
  public class YourSerenityTest {
      @Inject
      private ApiClient apiClient;
  
      // 测试逻辑
  }
  

2. 测试未正确启动Micronaut上下文 #

Serenity测试运行器可能未触发Micronaut上下文初始化，导致Bean容器未加载。

• 检查点：测试类是否添加了@MicronautTest注解（用于启动Micronaut测试上下文），或是否在Serenity配置中集成了Micronaut上下文启动逻辑。
• 修复：确保测试类顶部添加@MicronautTest；若为Serenity BDD场景类，需通过Micronaut上下文获取Bean，而非手动实例化。

3. 注解处理器未正确配置 #

Micronaut依赖注解处理器生成Bean元数据，若micronaut-inject-java未配置为注解处理器，会导致Bean无法被识别。

• Gradle配置检查：确保build.gradle中包含：

  annotationProcessor "io.micronaut:micronaut-inject-java"
  testAnnotationProcessor "io.micronaut:micronaut-inject-java"
  

• Maven配置检查：确保pom.xml的<build>-<plugins>中添加：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.8.1</version>
      <configuration>
          <annotationProcessorPaths>
              <path>
                  <groupId>io.micronaut</groupId>
                  <artifactId>micronaut-inject-java</artifactId>
                  <version>${micronaut.version}</version>
              </path>
          </annotationProcessorPaths>
      </configuration>
  </plugin>
  

4. OfflineServiceEndpointProvider的依赖未满足 #

该Bean依赖EmbeddedServer，若测试环境中嵌入式服务器未启动，会导致Bean无法实例化。

• 检查点：测试类是否启用了嵌入式服务器（@MicronautTest默认启动，除非配置server=false）。
• 修复：若测试类禁用了服务器，修改配置：

  @MicronautTest(server = true) // 显式启用嵌入式服务器
  public class YourSerenityTest {
      // ...
  }
  

5. Micronaut未扫描到Bean所在的包 #

如果OfflineServiceEndpointProvider或ApiClient所在包不在Micronaut默认扫描范围内，容器无法发现这些Bean。

• 检查点：确认application.properties是否配置了micronaut.packages，或带@MicronautApplication的主类是否在根包下（确保所有Bean类在其子孙包中）。
• 修复：在application.properties添加包扫描配置：

  micronaut.packages=com.yourpackage.path
  

6. 条件注解生效异常 #

虽然未配置canary.service-endpoint，但可能存在其他条件导致OfflineServiceEndpointProvider未被加载，可开启日志排查：

• 添加日志配置：在logback-test.xml或application.properties中开启trace日志：

  logger.level.io.micronaut.context.condition=TRACE
  

  运行测试后，查看日志中关于OfflineServiceEndpointProvider的条件判断结果，确认是否因其他条件未满足导致Bean未创建。

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