SpringBoot+HAPI FHIR构建GraalVM原生镜像启动报HAPI-1680错误

1. 确认R4结构依赖已正确引入 #

首先确保项目依赖中包含HAPI FHIR的R4结构包，Maven依赖配置如下：

<dependency>
    <groupId>ca.uhn.hapi.fhir</groupId>
    <artifactId>hapi-fhir-structures-r4</artifactId>
    <version>7.2.1</version>
</dependency>

注意：依赖scope需为compile（默认值），避免使用provided等会在构建原生镜像时被排除的scope。

2. 显式声明GraalVM需包含的类与资源 #

HAPI FHIR大量使用动态加载与反射，GraalVM静态分析无法自动识别这些内容，需通过以下方式配置：

方式一：使用Spring Native的@NativeHint注解 #

在Spring Boot主类或FHIR配置类上添加注解，指定需要包含的类和资源：

import org.springframework.nativex.hint.NativeHint;
import org.springframework.nativex.hint.ResourceHint;
import org.springframework.nativex.hint.TypeHint;
import org.springframework.nativex.hint.TypeAccess;

@NativeHint(
    typeHints = {
        @TypeHint(typeNames = "org.hl7.fhir.r4.model.*", access = TypeAccess.ALL),
        @TypeHint(typeNames = "ca.uhn.fhir.context.*", access = TypeAccess.ALL),
        @TypeHint(typeNames = "ca.uhn.fhir.parser.*", access = TypeAccess.ALL)
    },
    resources = {
        @ResourceHint(patterns = {"org/hl7/fhir/r4/**/*.json", "ca/uhn/fhir/**/*.properties"})
    }
)
@SpringBootApplication
public class YourFhirApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourFhirApplication.class, args);
    }
}

方式二：手动添加GraalVM配置文件 #

在src/main/resources/META-INF/native-image目录下创建以下文件：

• reflect-config.json（声明需要反射的类）：

[
    {
        "name": "org.hl7.fhir.r4.model.*",
        "allDeclaredConstructors": true,
        "allPublicConstructors": true,
        "allDeclaredMethods": true,
        "allPublicMethods": true,
        "allDeclaredFields": true,
        "allPublicFields": true
    },
    {
        "name": "ca.uhn.fhir.context.FhirContext",
        "allDeclaredConstructors": true,
        "allPublicConstructors": true,
        "allDeclaredMethods": true,
        "allPublicMethods": true
    }
]

• resource-config.json（声明需要包含的资源文件）：

{
    "resources": [
        {
            "pattern": "org/hl7/fhir/r4/**/*.json"
        },
        {
            "pattern": "ca/uhn/fhir/**/*.properties"
        }
    ]
}

3. 生成Spring AOT配置文件 #

执行Spring Boot的AOT处理命令，让框架自动生成适配原生镜像的配置：

• Maven：

mvn spring-boot:process-aot

• Gradle：

./gradlew processAot

执行后会在target/classes/META-INF/native-image或build/classes/java/main/META-INF/native-image下生成自动配置，可补充到项目的资源目录中。

4. 重新构建原生镜像 #

完成上述配置后，重新执行原生镜像构建命令，比如使用Spring Boot的build-image：

mvn spring-boot:build-image

内容的提问来源于stack exchange，提问作者Angelo Immediata