CentOS系统Java编译需要注意什么

CentOS 上 Java 编译的关键注意事项

一 环境与工具链

• 明确目标 JDK 版本：应用开发建议安装 JDK 8/11/17 等 LTS 版本；若需编译 OpenJDK 源码，需准备比目标版本低一版的 Bootstrap JDK（如编译 JDK 8 建议用 JDK 7；编译 JDK 11/12 常用 JDK 11 作为引导 JDK）。区分 JRE 与 JDK，编译阶段必须安装 JDK（包含 javac）。
• 安装基础工具链：执行 sudo yum groupinstall “Development Tools” 获取 gcc、make 等；按需补充 ncurses-devel、flex、bison、openssl-devel、elfutils-libelf-devel、perl、bc 等。
• 图形/音频/字体依赖（OpenJDK 构建常见）：libX11-devel、libXrender-devel、libXrandr-devel、libXi-devel、freetype-devel、cups-devel、alsa-lib-devel。
• 编译器版本（OpenJDK 8 及更早对 GCC 4.8 兼容性较差）：CentOS 7 默认 GCC 4.8.3，建议使用 devtoolset-7（GCC 7.3）或更高版本，通过 scl enable devtoolset-7 bash 启用后再构建。
• 构建工具：应用项目常用 Maven/Gradle；安装后在项目根目录执行 mvn -version / gradle -v 校验。

二 环境变量与编码

• 正确设置 JAVA_HOME 与 PATH：确保指向 JDK 安装目录（如 /usr/lib/jvm/java-11-openjdk 或 /usr/lib/jvm/java-1.8.0-openjdk），并将 $JAVA_HOME/bin 置于 PATH 前列；执行 source /etc/profile 或对应 shell 配置文件使其生效。
• 区分系统与应用的 JDK：避免误用 /usr/bin/java（可能指向 JRE 或系统默认 JDK），编译与打包统一使用同一 JAVA_HOME。
• 统一字符编码：源码、终端与构建日志建议使用 UTF-8，减少中文乱码与资源文件读取问题。

三 项目构建与依赖管理

• 使用构建工具管理依赖：在 Maven 的 pom.xml 或 Gradle 的 build.gradle 中声明依赖并执行 mvn clean package 或 gradle build；确保仓库可达、依赖版本一致。
• 本地库与类路径：若项目包含本地库（JNI），通过 -Djava.library.path 指定本地库路径，并在构建/运行期保持一致。
• 权限与目录：确保工作区与输出目录具备读写权限，避免因权限不足导致编译或测试失败。

四 OpenJDK 源码编译要点

• 准备引导 JDK：安装比目标低一版的 JDK，并设置 ALT_BOOTDIR 或 –with-boot-jdk 指向该 JDK。
• 安装依赖与开发头文件：按报错逐步补齐（如 alsa-lib-devel、cups-devel、freetype-devel、libXi-devel 等）。
• 配置与构建：在源码根目录执行 bash configure；成功后执行 make images 生成镜像，产物位于 build/<配置名>/jdk。
• 常用配置参数：
  • –with-debug-level=fastdebug|slowdebug|release（调试信息量与优化级别）
  • –with-jvm-variants=server,client,…（选择 HotSpot 变体）
  • –with-target-bits=64|32（目标架构）
  • –with-freetype=… / --with-x=…（外部依赖路径）
• 历史版本坑位提示：
  • OpenJDK 7 常见 CurrencyData.properties 时间戳校验错误，需将文件中时间改为近 10 年 内或调整构建脚本。
  • OpenJDK 8 已移除 make sanity 步骤，旧教程若包含该命令需忽略。

五 常见错误快速排查

• 命令未找到或版本不符：运行 java -version / javac -version 校验；若 javac 缺失，说明只装了 JRE 或未装 devel 包，安装对应 openjdk--devel。
• 依赖缺失：构建或 configure 阶段报缺库，按提示 yum install <缺失库>-devel；OpenJDK 构建常见缺 freetype、x11、alsa、cups 等开发包。
• 编码问题：源码含中文时报错或乱码，统一为 UTF-8 并检查终端/构建日志编码。
• 权限问题：无法写入 target/ 或无法读取依赖，使用 chmod/chown 调整权限或以合适用户运行。
• 构建工具异常：执行 mvn -version / gradle -v 确认安装与版本；若网络导致依赖拉取失败，检查仓库镜像与代理设置。