Kotlin开发的Spring Boot 3原生应用运行时出现count属性不存在错误

问题背景 #

构建基于Kotlin的Spring Boot 3 RC1应用并生成GraalVM原生镜像后，运行时抛出错误：

Failed to create query for method public abstract java.lang.Object org.springframework.data.repository.kotlin.CoroutineCrudRepository.count(kotlin.coroutines.Continuation); No property 'count' found for type 'Customer'

根本原因 #

GraalVM原生镜像的"封闭世界"特性限制了动态反射与代理生成，Spring Data Kotlin协程仓库的默认继承方法（如count）无法在运行时动态生成实现；同时Spring Boot 3 RC1版本存在部分原生镜像与Kotlin协程仓库的兼容问题。

可行解决方案 #

1. 升级到Spring Boot 3正式版 #

优先升级到正式版，RC版本的兼容问题已被修复：
修改build.gradle.kts中的版本配置：

plugins {
    id("org.springframework.boot") version "3.0.0"
    id("org.graalvm.buildtools.native") version "0.9.17"
    // 其他插件版本保持不变
}

2. 添加AOT元数据提示 #

若无法升级，通过注册RuntimeHints让GraalVM保留必要的反射与代理信息：
创建Native配置类：

package org.test.nativedemo

import org.springframework.aot.hint.MemberCategory
import org.springframework.aot.hint.RuntimeHints
import org.springframework.aot.hint.RuntimeHintsRegistrar
import org.springframework.context.annotation.Configuration
import org.springframework.context.annotation.ImportRuntimeHints

@Configuration
@ImportRuntimeHints(CustomerRepoHints::class)
class NativeConfig

class CustomerRepoHints : RuntimeHintsRegistrar {
    override fun registerHints(hints: RuntimeHints, classLoader: ClassLoader?) {
        // 注册仓库接口的JDK代理
        hints.proxies().registerJdkProxy(CustomerRepository::class.java)
        // 保留Customer实体类的所有反射信息
        hints.reflection()
            .registerType(Customer::class.java, MemberCategory.values().toList())
        // 保留CoroutineCrudRepository的方法调用权限
        hints.reflection()
            .registerType(org.springframework.data.repository.kotlin.CoroutineCrudRepository::class.java,
                MemberCategory.INVOKE_PUBLIC_METHODS,
                MemberCategory.DECLARED_METHODS)
    }
}

重新构建原生镜像：

./gradlew nativeCompile

3. 显式声明仓库方法 #

在CustomerRepository中显式重写count方法，帮助Spring Data在AOT阶段生成实现：

interface CustomerRepository : CoroutineCrudRepository<Customer, Int> {
    override suspend fun count(): Long
}

验证 #

执行以下命令运行原生镜像，检查是否正常启动：

./gradlew nativeRun

内容的提问来源于stack exchange，提问作者Kevin Tronkowski