IntelliJ已在项目结构设JDK 构建H2数据库源码仍提示JAVA_HOME未设置怎么办

对应你在IntelliJ项目结构中完成的JDK配置截图：

问题本质 #

IntelliJ项目结构中配置的JDK，仅服务于IDE自身的代码索引、语法校验功能，不会将配置值传递给构建流程启动的独立脚本进程。H2数据库的源码构建脚本会直接读取系统层面、构建进程维度的JAVA_HOME环境变量，和IDEA内部的JDK配置链路完全独立，因此会出现已在项目内完成JDK配置、仍报错提示未设置JAVA_HOME的问题。

落地解决步骤 #

• 第一步：获取准确的JDK根目录路径
  注意路径必须指向JDK的Home层级目录，不能误选到JRE子目录。参考有效路径示例：Windows下为C:\dev\jdk-17.0.9，macOS下为/Library/Java/JavaVirtualMachines/zulu17.46.19-ca-jdk17.0.9/Contents/Home
• 方案1：配置系统全局环境变量
  • Windows端：打开系统环境变量配置面板，新建名为JAVA_HOME的系统变量，变量值填写上述获取的JDK根目录；在系统Path变量中追加%JAVA_HOME%\bin条目，保存配置后完全退出所有终端、IntelliJ IDEA进程，再重新启动触发构建
  • macOS端：编辑用户目录下的Shell配置文件（默认zsh对应~/.zshrc，bash对应~/.bash_profile），追加两行配置：

    export JAVA_HOME=你的JDK Home目录完整路径
    export PATH=$JAVA_HOME/bin:$PATH
    

    保存后在终端执行source 对应的配置文件路径使配置生效，再完全重启IDEA
• 方案2：仅为IDEA构建进程单独配置JAVA_HOME（无需修改全局系统配置）
  打开IDEA设置面板，依次进入「构建、执行、部署」-「构建工具」-「Maven/Gradle」配置页，在Runner的环境变量配置项中，新增名为JAVA_HOME的环境变量，值填写JDK根目录路径，保存后直接触发构建即可
• 路径兼容性校验
  确认配置的JAVA_HOME路径中无中文、空格、特殊字符。部分版本的H2构建脚本对带空格的Windows默认安装路径（如C:\Program Files\Java\jdk-xxx）兼容性较差，遇到这类情况可将JDK移动到无特殊字符的路径下重新配置

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