在 Ubuntu 上提升 Java 编译稳定性的实用方案
一 基础环境与工具链
- 保持系统与软件包为最新，减少依赖与工具链不一致带来的不确定性：执行 sudo apt update && sudo apt upgrade。
- 安装并固定一个 LTS 版本的 JDK（如 OpenJDK 11/17），避免多版本混用：sudo apt install openjdk-17-jdk。
- 正确设置 JAVA_HOME 与 PATH，确保构建工具与脚本能稳定找到编译器：
- 查找安装路径：readlink -f $(which java)
- 写入配置（示例为 OpenJDK 17）：
- echo ‘export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64’ >> ~/.bashrc
- echo ‘export PATH=$JAVA_HOME/bin:$PATH’ >> ~/.bashrc
- source ~/.bashrc
- 验证环境：java -version、javac -version、echo $JAVA_HOME 均应返回预期值。
二 内存与交换分区优化
- 为构建进程（如 javac 或 Maven）配置合理的堆内存，避免编译期 OOM 或频繁 GC：
- Maven 全局配置：export MAVEN_OPTS=“-Xms2g -Xmx2g”（根据机器内存调整，通常不超过物理内存的 50%）。
- 直接使用 javac 时可通过环境变量传入：export JAVA_OPTS=“-Xms1g -Xmx2g”。
- 当物理内存较小或并行任务较多时，增加 Swap 能显著降低因内存紧张导致的进程被 OOM Killer 终止的风险：
- 临时增加 2GB 交换文件：
- sudo fallocate -l 2G /swapfile
- sudo chmod 600 /swapfile
- sudo mkswap /swapfile
- sudo swapon /swapfile
- 永久生效：echo ‘/swapfile none swap sw 0 0’ | sudo tee -a /etc/fstab
- 验证：free -m 查看 Swap 是否生效。
- 在 Android/AOSP 等大工程场景中，可适当增大 JavacHeapSize（如由 2048M 提升到 4096M），以减少 javac 阶段因堆不足被系统终止的概率。
三 构建过程与工程配置
- 使用构建工具的“稳定模式”：
- Maven 建议固定版本（如使用官方仓库的 Maven 3.8.x/3.9.x），并在 settings.xml 中配置可靠镜像源与合适的并行度（-T 选项），减少网络抖动与资源争用。
- 控制并行度与资源占用：
- 并行编译会提升速度，但也可能放大内存与 I/O 压力；在 CI 或资源受限机器上，降低并行度（如 -T 1C 或更低）通常能提升稳定性。
- 大工程清理策略：
- 在调整内存/堆参数或升级 JDK 后，执行一次全量清理（如删除 out/ 目录或执行 mvn clean），避免增量构建命中陈旧状态。
- 持续集成建议：
- 在 CI 脚本中显式设置 JAVA_HOME、MAVEN_OPTS，并固定工具链版本；为关键任务设置超时与重试，减少偶发性失败对流水线的影响。
四 监控与快速定位
- 快速健康检查清单：
- 版本一致性：java -version、javac -version、JAVA_HOME 是否匹配预期。
- 资源可用性：free -m（内存与 Swap）、df -h（磁盘空间）、ulimit -a（文件句柄与进程数限制）。
- 构建命令是否正确、依赖是否可解析（Maven 可先 mvn dependency:resolve 验证）。
- 典型症状与对策：
- 构建进程被系统杀死（日志含 “Killed” 或返回码 137）：多为内存不足，按上文增加 Swap 并适当下调并行度或提升堆上限。
- 偶发性网络依赖失败：切换为稳定镜像源、增加重试与超时配置。
- 环境变量异常：echo $JAVA_HOME 为空或路径不存在，按上文重新设置并 source 配置。
