GraalVM Native Image生成Scala项目可执行文件失败求助

我有一个仅依赖Scala库的简单Scala项目，使用sbt-assembly插件构建Jar包，相关配置如下：

项目配置文件 #

build.sbt #

name := "Bigjar"

version := "1.0.0"

scalaVersion := "3.4.2"

assembly / assemblyMergeStrategy := {
    case PathList("META-INF", xs @ _*) => MergeStrategy.discard
    case "reference.conf" => MergeStrategy.concat
    case x => MergeStrategy.first
}

build.properties #

sbt.version=1.10.0

assembly.sbt #

addSbtPlugin("com.eed3si9n" % "sbt-assembly" % "2.2.0")

问题1：Native Image反射构建失败 #

执行命令 native-image -jar target/scala-3.4.2/bigjar.jar 时，出现Scala库内部反射未配置的错误，核心日志如下：

Warning: Reflection method java.lang.Class.getMethods invoked at scala.Enumeration.populateNameMap(Enumeration.scala:201)
Warning: Reflection method java.lang.Class.getDeclaredFields invoked at scala.Enumeration.getFields$1(Enumeration.scala:195)
Warning: Aborting stand-alone image build due to reflection use without configuration.

我未使用Enumeration，推测问题来自Scala标准库本身，尝试过GraalVM官方文档的反射解决方案但无效。

问题2：sbt-native-image版本匹配错误 #

使用sbt-native-image插件时，配置如下：

plugins.sbt #

logLevel := Level.Warn
addSbtPlugin("org.scalameta" % "sbt-native-image" % "0.3.4")

修改后的build.sbt #

name := "Bigjar"

version := "1.0.0"

scalaVersion := "3.4.2"

lazy val example = project.enablePlugins(NativeImagePlugin).settings(
    mainClass.in(Compile) := Some("com.Launcher")
)

执行sbt nativeImage时出现版本匹配错误：

JVM graalvm-java11:20.2.0 not found in index: No graalvm-java11 version matching '20.2.0' found

当前环境：Scala 3.4.2、sbt 1.10.0、Oracle GraalVM 22.0.2+9.1

一、解决Scala库引发的Native Image反射问题 #

1. 自动生成反射元数据 #

利用GraalVM的native-image-agent捕获运行时反射调用，自动生成配置：

• 先在JVM模式下运行Jar包，生成元数据：

  java -agentlib:native-image-agent=config-output-dir=./META-INF/native-image -jar target/scala-3.4.2/bigjar.jar
  

• 生成的reflect-config.json等文件会存放在./META-INF/native-image目录，修改sbt-assembly的合并策略，确保这些文件被保留：

  assembly / assemblyMergeStrategy := {
      case PathList("META-INF", "native-image", xs @ _*) => MergeStrategy.first
      case PathList("META-INF", xs @ _*) => MergeStrategy.discard
      case "reference.conf" => MergeStrategy.concat
      case x => MergeStrategy.first
  }
  

• 重新打包后，再执行Native Image构建：

  native-image -jar target/scala-3.4.2/bigjar.jar
  

2. 手动添加Scala Enumeration反射配置 #

如果自动生成无效，手动创建src/main/resources/META-INF/native-image/reflect-config.json，添加以下内容：

[
  {
    "name": "scala.Enumeration",
    "allDeclaredConstructors": true,
    "allPublicConstructors": true,
    "allDeclaredMethods": true,
    "allPublicMethods": true,
    "allDeclaredFields": true,
    "allPublicFields": true
  },
  {
    "name": "scala.Enumeration$Val",
    "allDeclaredConstructors": true,
    "allPublicConstructors": true,
    "allDeclaredMethods": true,
    "allPublicMethods": true,
    "allDeclaredFields": true,
    "allPublicFields": true
  }
]

同样调整sbt-assembly的合并策略保留该文件，重新打包构建。

3. 显式启用Scala特性 #

在Native Image命令中强制启用GraalVM的Scala支持特性：

native-image --features=com.oracle.svm.polyglot.scala.ScalaFeature -jar target/scala-3.4.2/bigjar.jar

二、解决sbt-native-image版本匹配问题 #

1. 指定本地GraalVM路径 #

直接使用已安装的GraalVM，修改build.sbt：

lazy val example = project.enablePlugins(NativeImagePlugin).settings(
    mainClass.in(Compile) := Some("com.Launcher"),
    // 利用JAVA_HOME指向本地GraalVM，或直接写绝对路径
    nativeImageGraalHome := Some(file(System.getenv("JAVA_HOME")))
)

2. 升级sbt-native-image版本 #

旧版0.3.4不支持高版本GraalVM，升级到兼容版本：
修改plugins.sbt：

logLevel := Level.Warn
addSbtPlugin("org.scalameta" % "sbt-native-image" % "0.4.1")

3. 命令行指定GraalVM路径 #

临时在sbt命令中指定本地GraalVM路径：

sbt "set nativeImageGraalHome := Some(file(\"$JAVA_HOME\"))" nativeImage

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