Sbt报错：JDK版本不符合要求，但已安装最新Java

这种情况我之前踩过坑！明明本地装了最新版JDK，sbt却报错说版本是0，十有八九是环境变量配置不到位，或者sbt没找到正确的Java路径。下面是几个亲测有效的排查和解决步骤：

• 先确认Java的实际运行状态
  打开终端/命令提示符，分别输入：

  java -version
  javac -version
  

  如果这两个命令都能正常输出你安装的最新Java版本，说明Java本身安装没问题，问题出在sbt的路径识别上；如果命令报错，那得先把Java的bin目录加入系统PATH，同时设置JAVA_HOME指向JDK的安装根目录。

• 强制给sbt指定Java路径
  可以通过配置文件让sbt直接读取你指定的JDK：

  • 项目级配置：在项目根目录的project文件夹下创建或修改build.properties，加入：

    javaHome := Some(file("/path/to/your/jdk"))
    

  • 全局配置：修改sbt的全局配置文件（Windows是C:\Users\<你的用户名>\.sbt\1.0\global.sbt，Linux/macOS是~/.sbt/1.0/global.sbt），同样加入上面的代码。
    记得把/path/to/your/jdk换成实际的JDK路径，比如Windows下可能是C:\Program Files\Java\jdk-21，macOS下是/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home。

• 检查环境变量的优先级
  有时候系统里残留的旧Java路径会抢占优先级，导致sbt读错：

  • 用echo %PATH%（Windows）或echo $PATH（Linux/macOS）查看PATH里的Java相关目录，确保最新JDK的bin目录排在最前面。
  • 验证JAVA_HOME是否正确：输入echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（Linux/macOS），确认输出的是你安装的JDK根目录。

• 重启终端/IDE生效配置
  修改环境变量或配置文件后，终端和IDE不会自动加载新配置，必须重启一下。比如用IntelliJ开发的话，重启IDE后重新导入sbt项目，大概率就能识别到正确的Java版本了。

• 升级sbt版本适配最新JDK
  如果你用的是较旧的sbt版本，可能对最新JDK的支持不完善。可以在项目的project/build.properties里设置最新的sbt稳定版，比如：

  sbt.version=1.9.6
  

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