SBT跨编译Scala项目至不同JDK版本配置方法咨询

针对你的需求，SBT 1.9+ 确实原生支持跨JDK版本编译，crossJavaVersions设置失效通常是配置不完整或执行方式不对导致的。以下是经过验证的可行配置方案：

核心配置步骤 #

1. 基础配置（build.sbt） #

首先在build.sbt中指定目标JDK版本，并确保编译输出目录隔离：

// 声明要跨编译的JDK版本
crossJavaVersions := Seq(JavaVersion("11"), JavaVersion("17"))

// 为不同JDK版本单独设置输出目录，避免编译产物冲突
crossTarget := target.value / s"scala-${scalaVersion.value}-java-${javaVersion.value}"

// 确保Scala版本兼容目标JDK：Scala 2.12.15+ 正式支持JDK17
scalaVersion := "2.12.18"

2. 自动探测JDK（推荐） #

如果不想手动指定JDK路径，可使用sbt-java-home插件自动识别系统中的JDK：

• 在project/plugins.sbt中添加插件：

addSbtPlugin("org.scala-sbt" % "sbt-java-home" % "0.4.0")

插件会自动匹配crossJavaVersions中声明的JDK版本，无需额外配置javaHome。

3. 手动指定JDK路径（可选） #

如果系统中JDK未自动识别，可手动绑定环境变量：

// 从环境变量读取JDK路径， fallback到本地路径
lazy val java11Home = file(sys.env.getOrElse("JAVA11_HOME", "/usr/lib/jvm/java-11-openjdk"))
lazy val java17Home = file(sys.env.getOrElse("JAVA17_HOME", "/usr/lib/jvm/java-17-openjdk"))

// 根据当前指定的javaVersion绑定对应JDK
Compile / javaHome := javaVersion.value match {
  case JavaVersion("11") => Some(java11Home)
  case JavaVersion("17") => Some(java17Home)
  case _ => None
}

执行编译命令 #

配置完成后，无需手动指定-java-home，直接通过切换javaVersion执行编译：

# 编译JDK11版本
sbt "set javaVersion := JavaVersion(\"11\"); package"

# 编译JDK17版本
sbt "set javaVersion := JavaVersion(\"17\"); package"

简化命令（可选） #

在build.sbt中添加命令别名，进一步简化操作：

addCommandAlias("jdk11", "set javaVersion := JavaVersion(\"11\"); package")
addCommandAlias("jdk17", "set javaVersion := JavaVersion(\"17\"); package")

之后直接执行：

sbt jdk11
sbt jdk17

常见问题排查 #

1. crossJavaVersions警告/失效：

   • 确保Scala版本符合JDK兼容性：Scala 2.12需≥2.12.15才能支持JDK17；
   • 检查是否正确切换javaVersion，而非直接用默认JDK运行SBT；
   • 若使用手动指定JDK路径，确认路径存在且权限正常。

2. 编译产物冲突：

   • 必须配置crossTarget隔离不同JDK/Scala版本的输出目录，否则会覆盖之前的编译结果。

成功案例参考 #

不少开源项目已采用此方案实现跨JDK编译，比如Akka、Play Framework的部分模块，均通过crossJavaVersions配合sbt-java-home插件完成多JDK版本的构建流程。

内容的提问来源于stack exchange，提问作者Higher-Kinded Type