GraalVM Native镜像下Spring Data JPA集成Kotlin JDSL异常修复问询

问题描述 #

Kotlin JDSL提供KotlinJdslJpqlExecutor接口，允许Spring Data JPA仓库接口同时继承JpaRepository和该接口，示例代码如下：

@Entity
class MyEntity {
    @Id
    var id: UUID = UUID.randomUUID()
}

@Repository
interface MyEntityRepository: JpaRepository<MyEntity, UUID>, KotlinJdslJpqlExecutor

这段代码在Spring Boot 3.x + OpenJDK 21环境下运行正常，但编译为GraalVM Native镜像后，会抛出以下异常：

Caused by: org.springframework.data.mapping.PropertyReferenceException: No property 'update' found for type 'MyEntity'

或：

Caused by: org.springframework.data.mapping.PropertyReferenceException: No property 'findAll' found for type 'MyEntity'

问题根源 #

问题出在Spring AOT编译的特性：BeanPostProcessor的实现不会在AOT处理阶段被调用。Kotlin JDSL原本通过KotlinJdslJpaRepositoryFactoryBeanPostProcessor（一个BeanPostProcessor实现）为继承KotlinJdslJpqlExecutor的仓库设置自定义实现，但在Native镜像构建时，这个后置处理器无法生效，导致仓库接口的方法找不到对应的实现逻辑，最终抛出异常。

解决方案 #

方案一：自定义Repository工厂Bean #

绕过BeanPostProcessor，直接通过自定义工厂Bean为仓库绑定KotlinJdslJpqlExecutor实现：

1. 实现自定义JpaRepositoryFactoryBean：

class KotlinJdslRepositoryFactoryBean<T : Repository<S, ID>, S, ID>(
    repositoryInterface: Class<T>
) : JpaRepositoryFactoryBean<T, S, ID>(repositoryInterface) {

    @Lazy
    @Autowired
    lateinit var kotlinJdslJpqlExecutor: KotlinJdslJpqlExecutor

    override fun createRepositoryFactory(entityManager: EntityManager): RepositoryFactorySupport {
        val factory = super.createRepositoryFactory(entityManager)
        // 检查当前仓库是否继承了KotlinJdslJpqlExecutor
        if (KotlinJdslJpqlExecutor::class.java.isAssignableFrom(repositoryInterface)) {
            factory.addRepositoryProxyPostProcessor { proxyFactory ->
                proxyFactory.addAdvice(KotlinJdslRepositoryMethodInterceptor(kotlinJdslJpqlExecutor))
            }
        }
        return factory
    }
}

2. 在仓库接口上指定该工厂Bean：

@Repository
@RepositoryFactoryBean(KotlinJdslRepositoryFactoryBean::class)
interface MyEntityRepository : JpaRepository<MyEntity, UUID>, KotlinJdslJpqlExecutor

方案二：手动实现仓库接口（更简单） #

直接编写仓库实现类，通过委托模式复用JpaRepository和KotlinJdslJpqlExecutor的逻辑：

1. 定义仓库接口（仅作为契约）：

interface MyEntityRepository : JpaRepository<MyEntity, UUID>, KotlinJdslJpqlExecutor

2. 编写实现类：

@Repository
class MyEntityRepositoryImpl(
    private val jpaDelegate: JpaRepository<MyEntity, UUID>,
    private val jdslDelegate: KotlinJdslJpqlExecutor
) : MyEntityRepository by jpaDelegate, KotlinJdslJpqlExecutor by jdslDelegate

补充：AOT元数据配置（可选） #

如果遇到类未被正确代理或方法无法访问的问题，可在src/main/resources/META-INF/spring/aot.factories中添加以下配置，确保Kotlin JDSL相关类被AOT处理：

org.springframework.aot.hint.RuntimeHintsRegistrar=com.linecorp.kotlinjdsl.support.spring.data.jpa.KotlinJdslRuntimeHints

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