应使用与源码版本严格匹配的构建脚本，如 jdk 17u 源码必须用 jdk17u 分支的 configure 脚本，否则会因参数校验失败或特性不识别而报错。
用什么版本的构建脚本和源码匹配最稳
OpenJDK 官方不提供预编译的“可直接 build 的源码包”，你下载的 jdkXu-src.zip 或 git clone 的仓库，必须和对应版本的构建脚本（configure、make 规则）严格匹配。比如 JDK 17u 的源码不能用 JDK 21 的 configure 脚本跑——它会卡在 --with-jvm-variants 参数校验或直接报 Unknown JVM feature: zgc。
实操建议：
- 从 https://www.php.cn/link/042e830eefee166996d5f71239ee1e4c 进入对应分支（如
jdk17u），点 “Code → Download ZIP”，别下 release 页面的 src.zip（常缺make/和conf/） - 构建前先运行
bash configure --help | head -20，确认输出里有你打算启用的特性（如zgc、shenandoahgc），没有就说明脚本太旧或分支不对 - JDK 8u 用
./configure；JDK 9+ 必须用bash configure（不是./configure），否则权限或 shebang 会出问题
configure 报错 “The tested number of bits in the data type ‘void *’ is 32, but 64 was expected”
这是典型的宿主机架构和目标 JDK 架构不一致导致的硬性拦截。比如你在 macOS ARM64 上想编译 x86_64 JDK，或者 Linux x86_64 上没加 --openjdk-target=x86_64-linux-gnu，configure 就会按当前系统推断并报这个错。
实操建议：
- 明确目标产物架构：查你要复现的 JDK 发布页（如
jdk-17.0.1_linux-x64_bin.tar.gz），目标就是x86_64 - Linux 上编译 x86_64 JDK：必须加
--openjdk-target=x86_64-linux-gnu，且确保已装gcc-multilib和g++-multilib - macOS 上编译 aarch64 JDK：加
--openjdk-target=aarch64-apple-darwin，同时export JAVA_HOME指向已安装的 aarch64 JDK（不能是 Rosetta 转译的） - Windows 上别折腾，官方只支持用 WSL2 + Ubuntu 22.04 编译，且必须关掉 Windows Defender 实时扫描，否则
make images会卡死在Copy java.base
make images 卡住或生成的 jdk/bin/java 启动报 “Error: could not find libjava.so”
这不是编译失败，而是链接阶段没把 libjava.so（或 libjava.dylib）正确打进 build/*/images/jdk 目录，常见于自定义 --with-boot-jdk 路径含空格、符号链接，或 configure 时漏了 --enable-unlimited-crypto 导致某些 native 库跳过构建。
实操建议：
- 检查
build/*/images/jdk/lib/下是否存在libjava.so（Linux）、libjava.dylib（macOS）；没有就说明 native 层根本没编译成功 -
configure命令里务必显式指定--with-boot-jdk=/path/to/existing/jdk，路径不能有空格、不能是软链（用readlink -f展开） - 如果只想要最小可运行 JDK，加
--disable-warnings-as-errors --with-jvm-variants=server，避免因某个 GC 的 native 代码警告中断整个 build - 运行
make LOG=info images 2>&1 | grep -E "(libjava|ERROR|FATAL)"，快速定位 native 编译失败点
编译出来的 JDK 真的能当生产环境用吗
能跑 java -version 和简单 HelloWorld 不代表它通过了 JDK TCK（Technology Compatibility Kit）认证。OpenJDK 源码里自带的 test/ 是功能验证，但 TCK 是 Oracle 控制的闭源套件，未通过就不能叫 “兼容 JDK”。你自己改过 src/hotspot/share/oops/ 下任何一行，哪怕只是加个日志，这个 JDK 就只能用于调试或学习。
实操建议：
- 如果你目标是理解类加载或 GC 行为，编译时加
--enable-debug --with-debug-level=slowdebug，然后用gdb --args build/*/images/jdk/bin/java -XX:+PrintGCDetails HelloWorld单步跟 hotspot - 不要试图替换系统默认
JAVA_HOME指向自编译 JDK 运行 Spring Boot —— 它依赖的 JNI 接口行为可能和标准版有细微差异，尤其涉及java.nio或java.netnative 层 - 真正需要定制 JDK 的场景（如裁剪模块、打 patch），优先考虑基于
jdk-updates/jdk17u分支 cherry-pick 官方已合入的 commit，而不是自己魔改 hotspot 源码
最常被忽略的一点：configure 输出末尾的 Build performance summary 里会列出实际启用的 JVM 特性，比如 ZGC: disabled，但你代码里写了 -XX:+UseZGC，启动时只会静默回退到 ParallelGC，连 warning 都不报。
