Quarkus集成Apache POI GraalVM原生构建出现sun font未定义引用错误

问题根因 #

你手动添加的X11相关反射配置触发了AWT底层JNI依赖的缺失，GraalVM原生镜像默认不会主动引入sun.font包下的JNI实现，手动添加反射配置后编译器会强制链接这些不存在的符号，引发报错。

修复步骤 #

1. 移除你之前在reflection-config.json中添加的两个sun.awt相关的反射配置，无需手动配置这些类。
2. 在application.properties中添加Quarkus原生AWT支持开关：

# 开启Quarkus官方原生AWT支持，自动处理反射、JNI、系统库依赖
quarkus.native.enable-awt=true
# 开启headless模式，避免运行时依赖X11服务
quarkus.native.additional-build-args=-Djava.awt.headless=true
# 可选：如果需要内置字体支持，添加GraalVM参数
quarkus.native.additional-build-args=-H:+IncludeAllFonts

3. 优化POI配置，减少对系统字体的依赖（可选，推荐）
   在初始化SXSSFWorkbook之前添加如下系统配置：

// 关闭POI字体校验，避免调用系统字体接口
System.setProperty("org.apache.poi.ss.fontvalidation.disabled", "true");
// 若不需要自动调整列宽，不要调用autoSizeColumn方法，可完全避免字体依赖

4. 补全容器构建的系统依赖
   你使用-Dquarkus.native.container-build=true进行容器构建，默认的Quarkus构建镜像缺少字体相关依赖，需要自定义构建镜像安装如下包：

• freetype-devel
• fontconfig
• 可选：字体包（如wqy-zenhei-fonts等，解决中文显示问题）
  如果不想自定义构建镜像，也可以升级到Quarkus 2.7.x及以上LTS版本，官方构建镜像已默认包含AWT所需的系统依赖。

验证构建 #

配置完成后执行原有构建命令即可：

%M2_HOME%\bin\mvn package -Pnative -Dquarkus.native.container-build=true

内容的提问来源于stack exchange，提问作者Guilherme Santos