Ahead-of-Time optimizations fail when a Hibernate entity uses `java.sql.Clob`

[klopfdreh]

First of all thanks a lot for the great work on Spring Boot 4.x - the migration was very easy for us.

However, sadly we are facing an issue during a native image build with a java.sql.Clob within a Hibernate entity.

Framework-Versions:

• Spring Boot: 4.0.5
• Hibernate: 7.2.7
• Liberica: NIK 25.0.0+1 / JDK 25+37

Exception in thread "main" org.springframework.beans.factory.aot.AotProcessingException: Cannot contribute Ahead-of-Time optimizations for 'de.axa.lok.api.audit.AuditLogEntity'
	at org.springframework.data.aot.DefaultAotContext$ContextualTypeConfiguration.contribute(DefaultAotContext.java:241)
	at org.springframework.data.aot.DefaultAotContext.lambda$contributeTypeConfigurations$0(DefaultAotContext.java:108)
	at java.base/java.util.HashMap.forEach(HashMap.java:1430)
	at org.springframework.data.aot.DefaultAotContext.contributeTypeConfigurations(DefaultAotContext.java:107)
	at org.springframework.data.repository.config.AotRepositoryContextSupport.contributeTypeConfigurations(AotRepositoryContextSupport.java:96)
	at org.springframework.data.repository.config.RepositoryRegistrationAotProcessor.lambda$processAheadOfTime$0(RepositoryRegistrationAotProcessor.java:166)
	at org.springframework.data.repository.config.RepositoryRegistrationAotContribution.applyTo(RepositoryRegistrationAotContribution.java:63)
	at org.springframework.beans.factory.aot.BeanDefinitionMethodGenerator.lambda$generateBeanDefinitionMethod$0(BeanDefinitionMethodGenerator.java:165)
	at java.base/java.util.ArrayList.forEach(ArrayList.java:1604)
	at org.springframework.beans.factory.aot.BeanDefinitionMethodGenerator.generateBeanDefinitionMethod(BeanDefinitionMethodGenerator.java:165)
	at org.springframework.beans.factory.aot.BeanDefinitionMethodGenerator.generateBeanDefinitionMethod(BeanDefinitionMethodGenerator.java:89)
	at org.springframework.beans.factory.aot.BeanRegistrationsAotContribution$BeanDefinitionsRegistrationGenerator.generateBeanRegistration(BeanRegistrationsAotContribution.java:289)
	at org.springframework.beans.factory.aot.BeanRegistrationsAotContribution$BeanDefinitionsRegistrationGenerator.lambda$generateRegisterBeanDefinitionMethods$0(BeanRegistrationsAotContribution.java:272)
	at java.base/java.lang.Iterable.forEach(Iterable.java:75)
	at org.springframework.beans.factory.aot.BeanRegistrationsAotContribution$BeanDefinitionsRegistrationGenerator.generateRegisterBeanDefinitionMethods(BeanRegistrationsAotContribution.java:270)
	at org.springframework.beans.factory.aot.BeanRegistrationsAotContribution$BeanDefinitionsRegistrationGenerator.generateBeanRegistrationsCode(BeanRegistrationsAotContribution.java:238)
	at org.springframework.beans.factory.aot.BeanRegistrationsAotContribution.lambda$generateBeanRegistrationClass$0(BeanRegistrationsAotContribution.java:116)
	at org.springframework.aot.generate.GeneratedMethod.<init>(GeneratedMethod.java:54)
	at org.springframework.aot.generate.GeneratedMethods.add(GeneratedMethods.java:112)
	at org.springframework.aot.generate.GeneratedMethods.add(GeneratedMethods.java:89)
	at org.springframework.beans.factory.aot.BeanRegistrationsAotContribution.generateBeanRegistrationClass(BeanRegistrationsAotContribution.java:110)
	at org.springframework.beans.factory.aot.BeanRegistrationsAotContribution.generateBeanRegistrationCode(BeanRegistrationsAotContribution.java:88)
	at org.springframework.beans.factory.aot.BeanRegistrationsAotContribution.applyTo(BeanRegistrationsAotContribution.java:77)
	at org.springframework.context.aot.BeanFactoryInitializationAotContributions.applyTo(BeanFactoryInitializationAotContributions.java:94)
	at org.springframework.context.aot.ApplicationContextAotGenerator.lambda$processAheadOfTime$0(ApplicationContextAotGenerator.java:59)
	at org.springframework.context.aot.ApplicationContextAotGenerator.withCglibClassHandler(ApplicationContextAotGenerator.java:68)
	at org.springframework.context.aot.ApplicationContextAotGenerator.processAheadOfTime(ApplicationContextAotGenerator.java:54)
	at org.springframework.context.aot.ContextAotProcessor.performAotProcessing(ContextAotProcessor.java:107)
	at org.springframework.context.aot.ContextAotProcessor.doProcess(ContextAotProcessor.java:84)
	at org.springframework.context.aot.ContextAotProcessor.doProcess(ContextAotProcessor.java:49)
	at org.springframework.context.aot.AbstractAotProcessor.process(AbstractAotProcessor.java:84)
	at org.springframework.boot.SpringApplicationAotProcessor.main(SpringApplicationAotProcessor.java:96)
Caused by: org.springframework.data.mapping.MappingException: Cannot create PersistentEntity for 'de.axa.lok.api.audit.AuditLogEntity'
	at org.springframework.data.mapping.context.AbstractMappingContext.addPersistentEntity(AbstractMappingContext.java:430)
	at org.springframework.data.mapping.context.AbstractMappingContext.getPersistentEntity(AbstractMappingContext.java:322)
	at org.springframework.data.mapping.context.AbstractMappingContext.getPersistentEntity(AbstractMappingContext.java:248)
	at org.springframework.data.aot.AotMappingContext.contribute(AotMappingContext.java:60)
	at org.springframework.data.aot.DefaultAotContext$ContextualTypeConfiguration.doContribute(DefaultAotContext.java:260)
	at org.springframework.data.aot.DefaultAotContext$ContextualTypeConfiguration.contribute(DefaultAotContext.java:239)
	... 31 more
Caused by: org.springframework.data.mapping.MappingException: Cannot create PersistentEntity for 'java.sql.Clob'
	at org.springframework.data.mapping.context.AbstractMappingContext.addPersistentEntity(AbstractMappingContext.java:430)
	at org.springframework.data.mapping.context.AbstractMappingContext$PersistentPropertyCreator.lambda$createAndRegisterProperty$0(AbstractMappingContext.java:674)
	at java.base/java.lang.Iterable.forEach(Iterable.java:75)
	at org.springframework.data.mapping.context.AbstractMappingContext$PersistentPropertyCreator.createAndRegisterProperty(AbstractMappingContext.java:671)
	at org.springframework.data.mapping.context.AbstractMappingContext$PersistentPropertyCreator.doWith(AbstractMappingContext.java:625)
	at org.springframework.util.ReflectionUtils.doWithFields(ReflectionUtils.java:727)
	at org.springframework.data.mapping.context.AbstractMappingContext.doAddPersistentEntity(AbstractMappingContext.java:474)
	at org.springframework.data.mapping.context.AbstractMappingContext.addPersistentEntity(AbstractMappingContext.java:426)
	... 36 more
Caused by: org.springframework.data.mapping.MappingException: Cannot create PersistentEntity for 'java.io.Reader'
	at org.springframework.data.mapping.context.AbstractMappingContext.addPersistentEntity(AbstractMappingContext.java:430)
	at org.springframework.data.mapping.context.AbstractMappingContext$PersistentPropertyCreator.lambda$createAndRegisterProperty$0(AbstractMappingContext.java:674)
	at java.base/java.lang.Iterable.forEach(Iterable.java:75)
	at org.springframework.data.mapping.context.AbstractMappingContext$PersistentPropertyCreator.createAndRegisterProperty(AbstractMappingContext.java:671)
	at java.base/java.util.stream.ForEachOps$ForEachOp$OfRef.accept(ForEachOps.java:186)
	at java.base/java.util.stream.ReferencePipeline$2$1.accept(ReferencePipeline.java:197)
	at java.base/java.util.stream.ReferencePipeline$3$1.accept(ReferencePipeline.java:214)
	at java.base/java.util.stream.ReferencePipeline$2$1.accept(ReferencePipeline.java:197)
	at java.base/java.util.HashMap$ValueSpliterator.forEachRemaining(HashMap.java:1788)
	at java.base/java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:570)
	at java.base/java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:560)
	at java.base/java.util.stream.ForEachOps$ForEachOp.evaluateSequential(ForEachOps.java:153)
	at java.base/java.util.stream.ForEachOps$ForEachOp$OfRef.evaluateSequential(ForEachOps.java:176)
	at java.base/java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:265)
	at java.base/java.util.stream.ReferencePipeline.forEach(ReferencePipeline.java:632)
	at org.springframework.data.mapping.context.AbstractMappingContext$PersistentPropertyCreator.addPropertiesForRemainingDescriptors(AbstractMappingContext.java:642)
	at org.springframework.data.mapping.context.AbstractMappingContext.doAddPersistentEntity(AbstractMappingContext.java:475)
	at org.springframework.data.mapping.context.AbstractMappingContext.addPersistentEntity(AbstractMappingContext.java:426)
	... 43 more
Caused by: java.lang.reflect.InaccessibleObjectException: Unable to make protected java.io.Reader() accessible: module java.base does not "opens java.io" to unnamed module @25b485ba
	at java.base/java.lang.reflect.AccessibleObject.throwInaccessibleObjectException(AccessibleObject.java:353)
	at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible(AccessibleObject.java:329)
	at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible(AccessibleObject.java:277)
	at java.base/java.lang.reflect.Constructor.checkCanSetAccessible(Constructor.java:192)
	at java.base/java.lang.reflect.Constructor.setAccessible(Constructor.java:185)
	at org.springframework.util.ReflectionUtils.makeAccessible(ReflectionUtils.java:205)
	at org.springframework.data.mapping.PreferredConstructor.<init>(PreferredConstructor.java:54)
	at org.springframework.data.mapping.model.PreferredConstructorDiscoverer$Discoverers.buildPreferredConstructor(PreferredConstructorDiscoverer.java:248)
	at org.springframework.data.mapping.model.PreferredConstructorDiscoverer$Discoverers$1.discover(PreferredConstructorDiscoverer.java:136)
	at org.springframework.data.mapping.model.PreferredConstructorDiscoverer.discover(PreferredConstructorDiscoverer.java:85)
	at org.springframework.data.mapping.model.InstanceCreatorMetadataDiscoverer.discover(InstanceCreatorMetadataDiscoverer.java:117)
	at org.springframework.data.mapping.model.BasicPersistentEntity.<init>(BasicPersistentEntity.java:119)
	at org.springframework.data.mapping.model.BasicPersistentEntity.<init>(BasicPersistentEntity.java:100)
	at org.springframework.data.aot.AotMappingContext.createPersistentEntity(AotMappingContext.java:100)
	at org.springframework.data.aot.AotMappingContext.createPersistentEntity(AotMappingContext.java:45)
	at org.springframework.data.mapping.context.AbstractMappingContext.doAddPersistentEntity(AbstractMappingContext.java:451)
	at org.springframework.data.mapping.context.AbstractMappingContext.addPersistentEntity(AbstractMappingContext.java:426)
	... 60 more

The field of the class is just a simple:

    @Lob
    @Column(name = "DATA", nullable = false)
    private Clob data;

With Spring Boot 3.5.13 this was working without that error - which leads to the assumption that this might be a hibernate related issue, but I don't know for sure.

Thanks in advance.

[klopfdreh]

I was able to fix this by adding:

<jvmArguments>
  --add-opens java.base/java.io=ALL-UNNAMED
</jvmArguments>

to the configuration of the process-aot goal. Is this the right way to go?

[christophstrobl]

Thank you @klopfdreh for reporting. While add-opens will certainly work I'd like to understand why the MappingContext attempts to create a PersistentEntity for the type in first place. Do you have a minimal sample (something that we can unzip or git clone, build, and deploy) that reproduces the problem?

[klopfdreh]

Hey @christophstrobl - thanks a lot for the response. I don't know when I am able to find the time to create an example, but this problem should be reproducable by only create a simple jpa project that uses a clob as data type in an entity like explained in the initial bug report and then compile this as native image.

[christophstrobl]

AotMappingContext is missing a guard for java.sql similar to what's already present for javax.

[klopfdreh]

Thanks a lot for the investigation 👍

Is this fix in the next release?