提高 Ubuntu 上 Java 编译稳定性的实用方案
一 基础环境与工具链
- 保持系统与软件源稳定更新：执行sudo apt update && sudo apt upgrade，减少因系统库不一致导致的构建异常。
- 明确并固定 JDK 版本：安装与项目匹配的 OpenJDK（如 openjdk-11-jdk、openjdk-17-jdk），避免混用不同版本。
- 正确设置 JAVA_HOME 与 PATH：
- 查找安装路径：readlink -f $(which javac)
- 写入配置：export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64；export PATH=$JAVA_HOME/bin:$PATH
- 使配置生效：source ~/.bashrc 或 source ~/.profile
- 验证：java -version、javac -version 输出应一致且为期望的 JDK。
二 构建过程与资源配置
- 使用构建工具的最佳实践：
- Maven：在构建环境中导出堆内存，例如 export MAVEN_OPTS=“-Xms4096m -Xmx4096m”（根据机器内存调整，通常不超过物理内存的约一半）。
- Gradle：在 gradle.properties 中设置 org.gradle.jvmargs=-Xms4g -Xmx4g。
- 避免残留产物干扰：在大型或增量构建前执行全量清理（如删除 target/ 或 out/ 目录），减少因旧类或缓存导致的编译不一致。
- 正确管理依赖与类路径：
- 单文件编译使用 javac -cp /path/to/lib.jar Your.java
- 多模块/大型项目优先使用 Maven/Gradle 的依赖管理，避免手工维护 -cp。
三 内存与系统层面稳定性
- 预防 OOM 与被系统终止：
- 若出现构建进程被系统杀死（如日志出现 exit status 137 或 dmesg 提示 OOM），说明内存不足。
- 临时方案：增大 Swap（示例：dd if=/dev/zero of=/swap bs=1G count=4；mkswap /swap；swapon /swap；echo “/swap swap swap sw 0 0” >> /etc/fstab），并再次检查 free -m。
- 长期方案：为构建机配置充足物理内存，并合理设置构建工具的堆大小（如 -Xms/-Xmx）。
- 针对 AOSP/大型项目的专用调优：
- 若使用 Soong，可检查并适度提升 JavacHeapSize（例如由 2048M 提升到 4096M），以减小编译阶段因堆不足被系统终止的风险。
四 版本兼容与代码质量
- 保证编译器版本与源码/依赖兼容：项目要求 JDK 8 时，不要使用 JDK 11/17 进行编译；反之亦然。
- 统一团队与 CI 环境：在 CI 脚本中显式安装并切换到指定 JDK，避免“本地能编、CI 失败”。
- 前置语法与依赖校验：在提交/合并前使用 IDE 或命令行工具进行语法检查与依赖解析，降低因代码问题导致的编译波动。
五 快速排查清单
- 核对版本：java -version、javac -version 一致；JAVA_HOME 指向正确的 JDK 安装目录。
- 检查依赖与类路径：所有第三方库已下载且路径正确（Maven/Gradle 优先）。
- 观察资源：构建时监控内存与 Swap（free -m、top/htop），必要时增大 Swap 或降低并发/堆配置。
- 清理重建：删除 target/out 等构建产物后全量构建，排除历史产物干扰。
- 查看日志：关注 exit code（如 137）、OOM 提示与构建工具报错栈，优先定位资源与版本问题。