Micronaut集成测试批量运行时出现Bean加载失败问题

错误根源 #

批量运行测试时出现的Bean初始化冲突，本质是多测试类并发初始化ApplicationContext导致的Micronaut BeanContext并发冲突：

• 手动在setupSpec中启动EmbeddedServer的方式，没有利用Micronaut测试框架的上下文隔离/缓存机制，多个测试类同时启动上下文时，会触发RuntimeConfiguredEnvironment这个手动注册的单例Bean的创建冲突。
• SQLite文件的并发操作（删除、初始化）会间接导致上下文初始化延迟，当并发测试数量达到一定阈值时，冲突概率骤增；注释测试减少并发量、添加sleep给足初始化时间能缓解问题，也验证了这一点。

解决方案 #

方案1：改用Micronaut官方测试注解管理上下文（推荐） #

使用@MicronautTest注解让框架自动处理ApplicationContext的生命周期、隔离和注入，彻底规避手动初始化的并发问题：

abstract class BaseSpec extends Specification {
  @Shared
  protected WireMockServer wireMockServer

  @Inject
  protected EmbeddedServer embeddedServer

  @Inject
  protected ApplicationContext applicationContext

  @MicronautTest(environments = "integration")
  void setupSpec() {
    preSetupSpec()
    cleanDatabase()
    WireMock.configureFor("localhost", 8090)
    wireMockServer = new WireMockServer(options().port(8090))
    wireMockServer.start()
    
    // 保留Unirest配置
    Unirest.setHttpClient(HttpClientBuilder.create()
        .setConnectionManager(new BasicHttpClientConnectionManager())
        .build())
    Unirest.setObjectMapper(new com.mashape.unirest.http.ObjectMapper() {
      private ObjectMapper objectMapper = new ObjectMapper();

      @Override
      <T> T readValue(String value, Class<T> valueType) {
        return objectMapper.readValue(value, valueType)
      }

      @Override
      String writeValue(Object value) {
        return objectMapper.writeValueAsString(value);
      }
    })
    
    postSetupSpec()
  }

  protected void preSetupSpec() {}

  protected void postSetupSpec() {}

  private static void cleanDatabase() {
    def parent = System.getProperty("user.dir")
    new File(parent, "build/tmp/colleague-identity-distributed.db").delete()
  }

  void cleanupSpec() {
    wireMockServer.stop()
  }

  void setup() {
    if (!wireMockServer.isRunning()) {
      wireMockServer.start()
    }
    wireMockServer.resetAll()
    // 从注入的embeddedServer更新全局配置
    ApplicationSettings.BASE_URL = embeddedServer.URL.toString()
    ApplicationSettings.PORT = embeddedServer.URL.getPort()
  }

  void stubEndpoint(StubMapping stubMapping) {
    wireMockServer.addStubMapping(stubMapping)
  }
}

优势：完全遵循Micronaut测试设计，框架自动处理上下文的初始化、缓存和隔离，从根源解决并发冲突；依赖注入时机由框架控制，避免@Shared字段的注入时机问题。

方案2：手动强制上下文初始化串行化 #

如果无法使用@MicronautTest，可以通过静态锁确保同一时间只有一个测试类初始化ApplicationContext：

abstract class BaseSpec extends Specification {
  // 全局静态锁，保证上下文初始化串行执行
  private static final Object CONTEXT_INIT_LOCK = new Object()

  @Shared
  @Inject
  protected EmbeddedServer embeddedServer

  @AutoCleanup
  @Shared
  protected ApplicationContext applicationContext

  @AutoCleanup("shutdown")
  @Shared
  protected WireMockServer wireMockServer

  void setupSpec() {
    synchronized (CONTEXT_INIT_LOCK) {
      preSetupSpec()
      cleanDatabase()
      WireMock.configureFor("localhost", 8090)
      wireMockServer = new WireMockServer(options().port(8090))
      wireMockServer.start()
      
      // 保留Unirest配置
      Unirest.setHttpClient(HttpClientBuilder.create()
          .setConnectionManager(new BasicHttpClientConnectionManager())
          .build())
      Unirest.setObjectMapper(new com.mashape.unirest.http.ObjectMapper() {
        private ObjectMapper objectMapper = new ObjectMapper();

        @Override
        <T> T readValue(String value, Class<T> valueType) {
          return objectMapper.readValue(value, valueType)
        }

        @Override
        String writeValue(Object value) {
          return objectMapper.writeValueAsString(value);
        }
      })
      
      embeddedServer = ApplicationContext.run(EmbeddedServer, "integration")
      applicationContext = embeddedServer.applicationContext
      ApplicationSettings.BASE_URL = embeddedServer.URL.toString()
      ApplicationSettings.PORT = embeddedServer.URL.getPort()
      postSetupSpec()
    }
  }

  // 其余方法与原代码一致
}

优势：不改变原有测试结构，仅通过同步锁避免多测试类并发初始化上下文的冲突。

方案3：改用内存模式SQLite消除文件竞争 #

将SQLite改为内存模式，彻底避免数据库文件的并发操作问题，同时提升测试速度：

修改application-integration.yml的数据源配置：

datasources:
  default:
    url: jdbc:sqlite::memory:
    driverClassName: org.sqlite.JDBC

优势：每个测试上下文使用独立的内存数据库，完全规避文件锁、并发删除等问题，适合集成测试场景。

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