测试的预编译（AOT）支持

本章介绍了 Spring 的预编译（AOT）支持，用于使用 Spring TestContext 框架进行集成测试。

测试支持通过以下功能扩展了 Spring 的 核心 AOT 支持。

  • 在构建时检测当前项目中所有使用 TestContext 框架加载 ApplicationContext 的集成测试。

    • 为基于 JUnit Jupiter 和 JUnit 4 的测试类提供显式支持，并为 TestNG 和其他使用 Spring 核心测试注解的测试框架提供隐式支持——只要这些测试是使用为当前项目注册的 JUnit Platform TestEngine 运行的。

  • 构建时 AOT 处理：当前项目中每个唯一的测试 ApplicationContext 都将 为 AOT 处理而刷新。

  • 运行时 AOT 支持：在 AOT 运行时模式下执行时，Spring 集成测试将使用与 上下文缓存透明协作的 AOT 优化 ApplicationContext。

默认情况下，所有测试都在 AOT 模式下启用。但是，您可以通过使用 @DisabledInAotMode 注解来选择性地禁用 AOT 模式下的整个测试类或单个测试方法。 当使用 JUnit Jupiter 时，您可以通过 Jupiter 的 @EnabledInNativeImage 和 @DisabledInNativeImage 注解，选择性地在 GraalVM 本机镜像中启用或禁用测试。 请注意，@DisabledInAotMode 在 GraalVM 本机镜像中运行时也会禁用带注解的测试类或测试方法，类似于 JUnit Jupiter 的 @DisabledInNativeImage 注解。

默认情况下，如果在构建时 AOT 处理期间遇到错误，将抛出异常，并且整个过程将立即失败。 如果您希望在遇到错误后继续构建时 AOT 处理，您可以禁用 failOnError 模式，这将导致错误以 WARN 级别记录，或以 DEBUG 级别记录更详细的信息。 failOnError 模式可以通过在命令行或构建脚本中将名为 spring.test.aot.processing.failOnError 的 JVM 系统属性设置为 false 来禁用。作为替代方案，您可以通过 SpringProperties 机制设置相同的属性。

@ContextHierarchy 注解在 AOT 模式下不受支持。

为了提供在 GraalVM 本机镜像中使用的测试特定运行时提示，您有以下选项。

TestRuntimeHintsRegistrar API 作为核心 RuntimeHintsRegistrar API 的补充。如果您需要为不特定于特定测试类的测试支持注册全局提示，请优先实现 RuntimeHintsRegistrar 而不是特定于测试的 API。

如果您实现自定义 ContextLoader，它必须实现 AotContextLoader 才能提供 AOT 构建时处理和 AOT 运行时执行支持。 但是请注意，Spring Framework 和 Spring Boot 提供的所有上下文加载器实现都已实现 AotContextLoader。

如果您实现自定义 TestExecutionListener，它必须实现 AotTestExecutionListener 才能参与 AOT 处理。 请参阅 spring-test 模块中的 SqlScriptsTestExecutionListener 以获取示例。