GluonHQ搭配Hibernate构建报错：无法解析net.bytebuddy相关类

问题概述 #

• 技术栈：Gluon + Hibernate 6.2.7.Final + ByteBuddy 1.12.18
• 异常现象：执行mvn gluonfx:runagent时应用正常启动，可正常访问数据库；但mvn clean gluonfx:build生成的exe无法运行，核心报错：

  Warning: Could not resolve net.bytebuddy.utility.Invoker$Dispatcher for reflection configuration. Reason: java.lang.ClassNotFoundException: net.bytebuddy.utility.Invoker$Dispatcher.

• 已尝试操作：排除Hibernate自带的ByteBuddy依赖后手动添加，问题未解决。

根本原因 #

Gluon Native Image基于GraalVM构建，会通过静态分析裁剪未被显式引用的类。ByteBuddy的Invoker$Dispatcher是动态生成的类，静态分析无法识别，导致构建时被裁剪，最终运行时出现类找不到的错误。

解决方案 #

1. 添加手动反射配置文件 #

在项目的src/main/resources/META-INF/native-image目录下创建reflect-config.json文件，写入ByteBuddy相关类的反射配置：

[
  {
    "name": "net.bytebuddy.utility.Invoker$Dispatcher",
    "allDeclaredConstructors": true,
    "allDeclaredMethods": true,
    "allDeclaredFields": true
  },
  {
    "name": "net.bytebuddy.utility.Invoker",
    "allDeclaredConstructors": true,
    "allDeclaredMethods": true,
    "allDeclaredFields": true
  }
]

2. 还原依赖配置 #

无需手动排除Hibernate自带的ByteBuddy依赖，保持默认依赖即可（Hibernate默认引入的ByteBuddy作用域为runtime，足够原生镜像构建使用）：

<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.2.7.Final</version>
</dependency>

3. 重新构建并测试 #

执行以下命令清理并重新构建原生镜像：

mvn clean gluonfx:build gluonfx:run

额外提示 #

• 若后续出现其他反射相关报错，可通过mvn gluonfx:runagent自动收集配置：运行应用并执行所有数据库操作后停止，target/gluonfx/agent-output目录会生成自动收集的配置，将其中的反射配置片段复制到reflect-config.json即可。
• Hibernate 6.x在原生镜像环境下还需配置JPA实体类的反射，可通过@RegisterForReflection注解标记实体类，或在reflect-config.json中添加实体类的反射配置。

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