Support for graalvm

[vpelikh]

Hello!

I’m working with Spring Modulith (https://github.com/spring-projects/spring-modulith), which depends on ArchUnit. I built it as a native image using GraalVM 25.0.1, and when I start the application, I encounter the following error:

2026-04-15T10:19:48.531Z  INFO 1 --- [calc-fp] [cTaskExecutor-1] [                                                 ] c.t.a.c.PluginLoader                     : Detected Java version 25.0.2
2026-04-15T10:19:48.531Z DEBUG 1 --- [calc-fp] [cTaskExecutor-1] [                                                 ] c.t.a.c.PluginLoader                     : Current Java version is compatible to JAVA_9 => Loading Plugin com.tngtech.archunit.core.importer.ModuleImportPlugin
2026-04-15T10:19:48.531Z  WARN 1 --- [calc-fp] [           main] [                                                 ] .r.c.ReactiveWebServerApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'healthEndpointGroupsBeanPostProcessor': java.lang.ExceptionInInitializerError
Application run failed
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'healthEndpointGroupsBeanPostProcessor': java.lang.ExceptionInInitializerError
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:610)
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:525)
	at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:333)
	at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:371)
	at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:331)
	at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:201)
	at org.springframework.context.support.PostProcessorRegistrationDelegate.registerBeanPostProcessors(PostProcessorRegistrationDelegate.java:277)
	at org.springframework.context.support.AbstractApplicationContext.registerBeanPostProcessors(AbstractApplicationContext.java:812)
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:605)
	at org.springframework.boot.web.server.reactive.context.ReactiveWebServerApplicationContext.refresh(ReactiveWebServerApplicationContext.java:69)
	at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:756)
	at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:445)
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:321)
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1365)
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1354)
	at ru.alfabank.app.ApplicationKt.main(Application.kt:15)
	at java.base@25.0.2/java.lang.invoke.LambdaForm$DMH/sa346b79c.invokeStaticInit(LambdaForm$DMH)
Caused by: java.util.concurrent.CompletionException: java.lang.ExceptionInInitializerError
	at java.base@25.0.2/java.util.concurrent.CompletableFuture.wrapInCompletionException(CompletableFuture.java:323)
	at java.base@25.0.2/java.util.concurrent.CompletableFuture.encodeThrowable(CompletableFuture.java:359)
	at java.base@25.0.2/java.util.concurrent.CompletableFuture.completeThrowable(CompletableFuture.java:364)
	at java.base@25.0.2/java.util.concurrent.CompletableFuture$AsyncSupply.run(CompletableFuture.java:1791)
	at java.base@25.0.2/java.lang.Thread.runWith(Thread.java:1487)
	at java.base@25.0.2/java.lang.VirtualThread.run(VirtualThread.java:456)
	at java.base@25.0.2/java.lang.VirtualThread$VThreadContinuation$1.run(VirtualThread.java:248)
Caused by: java.lang.ExceptionInInitializerError
	at com.tngtech.archunit.core.importer.ClassFileImporter.lambda$importPackages$1(ClassFileImporter.java:212)
	at java.base@25.0.2/java.util.stream.ReferencePipeline$7$1FlatMap.accept(ReferencePipeline.java:288)
	at java.base@25.0.2/java.util.ArrayList$ArrayListSpliterator.forEachRemaining(ArrayList.java:1716)
	at java.base@25.0.2/java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:570)
	at java.base@25.0.2/java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:560)
	at java.base@25.0.2/java.util.stream.ReduceOps$ReduceOp.evaluateSequential(ReduceOps.java:921)
	at java.base@25.0.2/java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:265)
	at java.base@25.0.2/java.util.stream.ReferencePipeline.collect(ReferencePipeline.java:723)
	at com.tngtech.archunit.core.importer.ClassFileImporter.importPackages(ClassFileImporter.java:213)
	at org.springframework.modulith.core.ApplicationModules.<init>(ApplicationModules.java:134)
	at org.springframework.modulith.core.ApplicationModules.<init>(ApplicationModules.java:96)
	at org.springframework.modulith.core.ApplicationModules.lambda$of$20(ApplicationModules.java:699)
	at java.base@25.0.2/java.util.concurrent.ConcurrentHashMap.computeIfAbsent(ConcurrentHashMap.java:1724)
	at org.springframework.modulith.core.ApplicationModules.of(ApplicationModules.java:696)
	at org.springframework.modulith.core.ApplicationModules.of(ApplicationModules.java:237)
	at org.springframework.modulith.core.ApplicationModules.of(ApplicationModules.java:219)
	at org.springframework.modulith.runtime.autoconfigure.SpringModulithRuntimeAutoConfiguration$ApplicationModulesBootstrap.initializeApplicationModules(SpringModulithRuntimeAutoConfiguration.java:238)
	at org.springframework.modulith.runtime.autoconfigure.SpringModulithRuntimeAutoConfiguration$ApplicationModulesBootstrap.lambda$new$0(SpringModulithRuntimeAutoConfiguration.java:202)
	at org.springframework.util.concurrent.FutureUtils.lambda$toSupplier$0(FutureUtils.java:74)
	at java.base@25.0.2/java.util.concurrent.CompletableFuture$AsyncSupply.run(CompletableFuture.java:1789)
	... 3 more
Caused by: com.tngtech.archunit.core.PluginLoader$PluginLoadingFailedException: Couldn't load plugin of type com.tngtech.archunit.core.importer.ModuleImportPlugin
	at com.tngtech.archunit.core.PluginLoader$PluginSupplier.create(PluginLoader.java:91)
	at com.tngtech.archunit.core.PluginLoader$PluginSupplier.get(PluginLoader.java:74)
	at com.tngtech.archunit.thirdparty.com.google.common.base.Suppliers$NonSerializableMemoizingSupplier.get(Suppliers.java:198)
	at com.tngtech.archunit.core.PluginLoader.load(PluginLoader.java:51)
	at com.tngtech.archunit.core.importer.ImportPlugin$Loader.loadForCurrentPlatform(ImportPlugin.java:40)
	at com.tngtech.archunit.core.importer.Locations.<clinit>(Locations.java:43)
	... 23 more
Caused by: java.lang.ClassNotFoundException: com.tngtech.archunit.core.importer.ModuleImportPlugin
	at org.graalvm.nativeimage.builder/com.oracle.svm.core.hub.ClassForNameSupport.forName(ClassForNameSupport.java:327)
	at org.graalvm.nativeimage.builder/com.oracle.svm.core.hub.ClassForNameSupport.forName(ClassForNameSupport.java:297)
	at java.base@25.0.2/java.lang.Class.forName(DynamicHub.java:1708)
	at java.base@25.0.2/java.lang.Class.forName(DynamicHub.java:1654)
	at java.base@25.0.2/java.lang.Class.forName(DynamicHub.java:1641)
	at com.tngtech.archunit.core.PluginLoader$PluginSupplier.create(PluginLoader.java:85)
	... 28 more

[ThoSap]

My 3+ years of experience of using GraalVM in Quarkus tells me:

Although this could be fixed in this lib by either not using reflection (I could imagine that this lib heavily relies on reflection) or by providing GraalVM reflection hints in META-INF/native-image/com.tngtech.archunit/archunit/reflect-config.json.
I do use ArchUnit in multiple projects, but I have not yet looked at its code beyond the API.

https://www.graalvm.org/latest/reference-manual/native-image/metadata/
https://www.graalvm.org/latest/reference-manual/native-image/metadata/AutomaticMetadataCollection/

@vpelikh to fix this today, you can either do:

1. Use the tracing agent, which will bloat the native image in size, in my experience
   https://docs.spring.io/spring-boot/reference/packaging/native-image/advanced-topics.html#packaging.native-image.advanced.using-the-tracing-agent

   The link in the Spring Boot docs does not seem to work...
   https://www.graalvm.org/latest/reference-manual/native-image/metadata/AutomaticMetadataCollection/

2. Manually configure the classes like com.tngtech.archunit.core.importer.ModuleImportPlugin from your exception (you will likely find other classes in the next run) until it works.
   I liked this approach more to keep the native image as small as possible.
   You could also use the tracing agent, see which classes have been registered, and then manually copy and register only the classes related to ArchUnit

   https://docs.spring.io/spring-boot/reference/packaging/native-image/advanced-topics.html#packaging.native-image.advanced.custom-hints
   https://docs.spring.io/spring-boot/reference/packaging/native-image/advanced-topics.html#packaging.native-image.advanced.custom-hints.static