Ubuntu系统编译Java程序所需依赖库详解

首页

编程语言

热心网友

转载

2026-05-07

Ubuntu 编译 OpenJDK 的依赖清单与版本要点

想在 Ubuntu 上成功编译 OpenJDK，准备工作是关键。这活儿说难不难，但依赖包和版本要是没搞对，后续的编译过程就会麻烦不断。下面这份清单，帮你把通用依赖和不同版本的差异化要点都理清楚了，照着来能省不少事儿。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

无论你编译哪个版本的 OpenJDK，下面这些基础依赖都是绕不开的。它们构成了编译的底层工具链，并支撑了 HotSpot 虚拟机、图形界面（AWT）、字体渲染和打印等核心模块。

构建工具与基础编译链：build-essential、gcc、g++、make、autoconf、zip。这是编译工作的“脚手架”。
字体与图形渲染：libfreetype6-dev、libfontconfig1-dev。没有它们，Ja va的字体显示会出问题。
打印系统：libcups2-dev。提供打印服务的底层支持。
X11 相关（窗口系统、渲染、测试等）：libx11-dev、libxext-dev、libxrender-dev、libxrandr-dev、libxtst-dev、libxt-dev。这一系列库负责图形界面的显示和交互。
音频：libasound2-dev。让Ja va程序能“发声”。
外部函数接口与兼容性：libffi-dev。用于本地接口调用。
源码获取工具：OpenJDK 源码托管在 Mercurial 仓库，所以需要安装 mercurial。

把这些通用依赖装齐，就为编译打下了最坚实的基础。

不同版本的 OpenJDK 对编译环境和引导JDK（Bootstrap JDK）的要求各不相同，这是最容易踩坑的地方。务必对号入座。

OpenJDK 7
- Bootstrap JDK：必须使用 JDK 7 本身。用 JDK 8 来编译 JDK 7 是行不通的。
- 构建工具：建议使用 Ant 1.9.x 版本。因为 Ant 1.10 及以上版本需要 JDK 8 支持，与 JDK 7 不兼容。
- 其他常见依赖：gawk、m4、ca-certificates、ca-certificates-ja va 这些工具和证书包也常常需要。
OpenJDK 8
- Bootstrap JDK：需要 JDK 7 作为引导。
- 常见依赖：除了通用依赖外，要特别确保 libx11-dev、libxext-dev、libxrender-dev、libxtst-dev、libxt-dev、libcups2-dev、libfreetype6-dev、libasound2-dev 这些库已安装。
OpenJDK 11/12/16 等更高版本
- Bootstrap JDK：遵循“N-1”原则。即编译 JDK 12 需要用 JDK 11 作为引导，编译 JDK 16 则需要 JDK 15，以此类推。
- 常见依赖：在通用依赖的基础上，再次核对 libfreetype6-dev、libfontconfig1-dev、libcups2-dev、X11 系列库、libasound2-dev、libffi-dev、autoconf 是否都已就位。

这些版本差异是无数实践经验的总结，编译前仔细核对能避免大部分基础错误。

为了操作方便，这里给出几条可以直接在终端执行的命令。你可以根据自己的目标版本进行选择。

Ubuntu 18.04/20.04/22.04（通用，适合 JDK 11+）
- sudo apt-get update
- sudo apt-get install -y build-essential autoconf zip libx11-dev libxext-dev libxrender-dev libxtst-dev libxt-dev libcups2-dev libfreetype6-dev libfontconfig1-dev libasound2-dev libffi-dev mercurial
如需编译 OpenJDK 7，在上述命令安装的基础上，还需要补充：gawk m4 ant-1.9.x ca-certificates ca-certificates-ja va。
如需编译 OpenJDK 8，最关键的一步是确保已安装 JDK 7 作为 Bootstrap JDK。可以通过 apt 安装 openjdk-7-jdk，或者手动下载解压后正确设置 JA VA_HOME 环境变量。

依赖装好了，只是第一步。接下来的配置（configure）阶段才是真正的考验。这里有几个关键参数和常见错误的解决方法。

使用 configure 明确依赖路径
- FreeType 库的路径经常需要手动指定，命令示例如下：
  bash configure --with-freetype-include=/usr/include/freetype2 --with-freetype-lib=/usr/lib/x86_64-linux-gnu
指定 Bootstrap JDK（示例）
- 明确告诉配置脚本引导JDK的位置：
  bash configure --with-boot-jdk=/usr/lib/jvm/ja va-11-openjdk-amd64
常见报错与处理
- “freetype not found” → 首先确认 libfreetype6-dev 已安装，然后在 configure 命令中正确设置 --with-freetype-include 和 --with-freetype-lib 路径。
- “fontconfig missing” → 安装 libfontconfig1-dev 包。
- “X11/xtst/xt missing” → 分别安装对应的 libx11-dev、libxtst-dev、libxt-dev 等开发包。
- “configure: error: Could not find a valid Boot JDK” → 检查是否安装了符合“N-1”原则的正确JDK版本，并通过 --with-boot-jdk 参数指定其绝对路径。
- “Ant version too new for JDK 7” → 编译 JDK 7 时，务必使用 Ant 1.9.x 版本，不要用更新的。
- “sanity check failed” → 这类综合性错误需要系统排查：检查 LANG 等环境变量是否设置正确（建议设为 C.UTF-8）；清理旧的 JA VA_HOME 或 CLASSPATH 设置；最后再整体确认一遍所有依赖是否安装齐全。