企业官网建设流程全解析

构建 JDK 时 Boot JDK 版本怎么选？--with-boot-jdk 怎么配置

【免费下载链接】jdkJDK main-line development https://openjdk.org/projects/jdk项目地址: https://gitcode.com/GitHub_Trending/jd/jdk

用 OpenJDK 源码构建 JDK 时，configure阶段有一个绕不开的前置依赖：你必须先装一个现成的 JDK 来驱动整个构建过程，这个 JDK 就叫Boot JDK。很多构建失败都出在这一步——configure自动探测不到 Boot JDK，或者选了一个版本不对、缺少javac的 JDK。这篇文章基于仓库内的 doc/building.md 和 make/autoconf/boot-jdk.m4，讲清楚 Boot JDK 的版本选择规则，以及--with-boot-jdk的用法、失败信息和验证方式。

Boot JDK 版本怎么选

doc/building.md 的 "Boot JDK Requirements" 一节给出的选择规则：

• N-1 规则：构建主版本为N的 JDK，Boot JDK 应选主版本N-1的 JDK。文档举例：构建 JDK 18 时用 JDK 17 作为 Boot JDK 是合适的。
• 当前源码自举：JDK 应该能"构建自己"，所以一个与当前源码一致的、最新的构建产物也是可接受的替代方案。
• N-2 过渡期：发布周期早期，版本N-1可能尚未发布，此时优先选版本N-2，直到N-1可用。
• 必须用最新的 update 版本：如果遵循 N-1 规则，确保拿到的是该主版本的最新 update 版本。文档提醒：例如 JDK 8 GA 在部分平台上可能无法构建 JDK 9。

Boot JDK 不需要是直接从 OpenJDK 社区源码构建出来的 JDK；移植到新平台时，该平台上已有的其他发行版 JDK 也可以当 Boot JDK 用。

具体到当前仓库的主线源码，允许哪些 Boot JDK 版本写在 make/conf/version-numbers.conf 中：

DEFAULT_VERSION_FEATURE=28 DEFAULT_ACCEPTABLE_BOOT_VERSIONS="26 27 28"

也就是说，当前主线（feature 28）接受主版本 26、27、28 的 Boot JDK。boot-jdk.m4在探测时就是拿java -version的输出和这份可接受版本列表做匹配，不在列表里的版本会被直接拒绝。所以如果你拉的源码分支不同，应以对应分支的make/conf/version-numbers.conf为准，而不是照搬本文的版本号。

从哪获取 Boot JDK

doc/building.md 的 "Getting JDK Binaries" 一节列出的获取方式：

• 预构建 JDK 二进制包的常见下载/安装途径，文档指向 OpenJDK 官方的安装说明页（openjdk.org/install）；
• Oracle JDK、Adoptium 发布的各平台预构建二进制包；
• 基于 apt 的 Linux 发行版（Debian、Ubuntu 等）：sudo apt-get install openjdk-<VERSION>-jdk；
• 基于 rpm 的发行版（Fedora、Red Hat 等）：sudo yum install java-<VERSION>-openjdk-devel。

其中<VERSION>替换为上面选定的主版本号，例如选 JDK 27 就装openjdk-27-jdk。

configure 如何自动探测 Boot JDK

不显式指定时，configure会按从"较确定"到"较猜测"的顺序逐级探测（逻辑见 make/autoconf/boot-jdk.m4）：

1. 命令行参数--with-boot-jdk指定的路径；
2. 环境变量JAVA_HOME（指向一个存在的目录时直接使用）；
3. macOS的/usr/libexec/java_home（先试默认，再逐个尝试可接受版本）；
4. PATH 中的javac/java：沿着符号链接回溯到真实的 JDK 目录（Linux 上javac常从/usr/bin经/etc/alternatives链接到真实 JDK）；
5. 平台默认安装位置：Windows 的Program Files/Java等虚拟目录、macOS 的/Library/Java/JavaVirtualMachines与/System/Library/Java/JavaVirtualMachines、Linux 的/usr/lib/jvm。

注意第 1 级有一个不对称的行为：如果显式传了--with-boot-jdk但路径无效，configure会立即报错退出（The path given by --with-boot-jdk does not contain a valid Boot JDK），不再继续往下探测；而其他探测级别失败则只是继续尝试下一级。

每个候选 JDK 还要通过有效性校验，全部通过才算找到：

• bin/java必须存在且可执行；
• bin/javac必须存在且可执行——只有 JRE 的目录会被拒绝，提示信息里会写(This might be an JRE instead of an JDK)；
• java -version输出的版本号必须匹配可接受版本列表，否则输出Potential Boot JDK found at ... is incorrect JDK version (...); ignoring，并附一行Your Boot JDK version must be one of: ...列出当前要求的版本。

所有探测都失败时，configure打印Could not find a valid Boot JDK，并给出提示This might be fixed by explicitly setting --with-boot-jdk，然后Cannot continue退出。doc/building.md 也说明，由于多数平台没有统一的安装位置，这套启发式探测失败率不低，所以显式指定是常态而非例外。

用 --with-boot-jdk 显式指定

参数定义见 doc/building.md 的 "Configure Arguments for External Dependencies"：

--with-boot-jdk=<path> - Set the path to the Boot JDK

用法示例（把<boot-jdk-home>换成你实际安装的 JDK 根目录，即包含bin/java、bin/javac的那一层）：

bash configure --with-boot-jdk=<boot-jdk-home>

关于路径形式，boot-jdk.m4的探测逻辑支持两种：

• JDK 目录：bin/java和bin/javac可直接执行，最常用；
• <xxx>.tar.gz归档：configure会先解压到构建支持目录（$CONFIGURESUPPORT_OUTPUTDIR/boot-jdk），再在其中查找bin/javac定位 JDK 根目录。

Windows 上注意构建系统内部统一用 Unix 风格路径（例如/cygdrive/c/...），传给configure的路径也应遵循这个规则。

与 Boot JDK 直接相关的还有--with-boot-jdk-jvmargs：用它给 Boot JDK 的所有工具调用附加 JVM 参数。doc/building.md 的 "Build Performance" 一节给出的示例：

bash configure --with-boot-jdk-jvmargs="-Xmx8G"

它会覆盖传给 Boot JDK 的默认 JVM 参数。另外一个容易踩的坑来自boot-jdk.m4的硬检查：如果环境变量_JAVA_OPTIONS或JAVA_TOOL_OPTIONS被设置，java -version输出里会出现Picked up ...字样，configure会直接报错终止，原文提示是This can mess up the build. Please use --with-boot-jdk-jvmargs instead.——即这类需求必须改走--with-boot-jdk-jvmargs，不能依赖全局环境变量。

特殊场景：交叉编译与 WSL

• 交叉编译：Boot JDK 必须能在build机器（构建机）上运行，而不是target机器上运行。注意它与 Build JDK 的区别——Build JDK 才是用当前源码构建出来、跑在构建机上的 JDK（构建过程会自动生成一个最小 Build JDK，可用--with-build-jdk指向预构建版本加速，但文档警告：Build JDK 与当前源码不完全一致时，构建结果不可预测且可能以隐蔽方式出错）。
• WSL：在 WSL 中既可构建 Windows 二进制也可构建 Linux 二进制。构建 Windows 二进制时，Boot JDK 必须放在 Windows 可访问的目录、且是 Windows 版的 JDK；构建 Linux 二进制（通过--build=x86_64-unknown-linux-gnu --openjdk-target=x86_64-unknown-linux-gnu）则必须用 Linux 版 Boot JDK。默认行为是构建 Windows 目标。

验证配置是否成功

判断 Boot JDK 是否配置正确，看bash configure的输出即可，boot-jdk.m4在探测成功后会打印：

checking for Boot JDK ... <选中的 JDK 路径> checking Boot JDK version ... <java -version 的首行输出>

如果输出的是Potential Boot JDK found at ... did not contain bin/javac、is incorrect JDK version这类行，说明该候选被拒，configure会继续探测或最终报Cannot continue——这时按提示显式加--with-boot-jdk指向一个完整且版本匹配的 JDK 重跑即可。doc/building.md 还提到 TL;DR 流程：configure因缺少 Boot JDK 失败时，多数情况下会打印针对你平台的解决建议，照做后重跑bash configure。

configure成功结束后会有一份性能摘要输出。之后继续构建并验证最终产物：

make images ./build/*/images/jdk/bin/java -version

能打出所构建 JDK 的版本信息，说明 Boot JDK 选型与配置这条前置链路已经走通。如果构建日志有异常，可查看$BUILD/build.log（上一次构建日志保存在build.log.old）。

【免费下载链接】jdkJDK main-line development https://openjdk.org/projects/jdk项目地址: https://gitcode.com/GitHub_Trending/jd/jdk