Native Image Testing (Maven)

Required dependencies
Plugin configuration for testing
Running native tests
Collecting test metadata
Skip options
Troubleshooting test failures

Required Dependencies

<dependencies>
  <dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>5.10.0</version>
    <scope>test</scope>
  </dependency>
</dependencies>

Also ensure you configure maven-surefire-plugin 3.0+:

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version><version-3.0+></version>
</plugin>

Plugin Configuration for Testing

Add the test goal execution to the native-maven-plugin:

<execution>
  <id>test-native</id>
  <goals>
    <goal>test</goal>
  </goals>
  <phase>test</phase>
</execution>

Running Native Tests

./mvnw -Pnative test

This compiles a native test binary and executes all discovered JUnit tests. For plugin-specific testing options, see the Native Build Tools Maven testing support. For debugger-based workflows, see Debug Native Tests in Maven and Gradle Projects.

Collecting Test Metadata

If nativeTest fails due to missing reflection or resource metadata, collect it with the tracing agent:

./mvnw -Pnative -Dagent=true test
./mvnw -Pnative native:metadata-copy
./mvnw -Pnative test

Configure the metadata copy to use the test output:

<agent>
  <enabled>true</enabled>
  <metadataCopy>
    <outputDirectory>META-INF/native-image</outputDirectory>
    <merge>true</merge>
    <disabledStages>
      <stage>main</stage>
    </disabledStages>
  </metadataCopy>
</agent>

Skip Options

Flag	Effect
`-DskipTests`	Skip all tests (JVM and native)
`-DskipNativeTests`	Run JVM tests only, skip native test compilation and execution

Troubleshooting Test Failures

"No tests found" in native test Ensure you declare maven-surefire-plugin 3.0+ in your build. If you use Maven Surefire prior to 3.0 M4 or your build forces an older JUnit Platform version, add junit-platform-launcher to test dependencies.

Tests pass on JVM but fail as native image Your test framework or dependencies use reflection not captured by metadata. Run ./mvnw -Pnative -Dagent=true test, then native:metadata-copy, then retry.

2.5 KiB Raw Blame History