Ubuntu 上解决 Jenkins 内存不足的可行方案
一 先快速定位问题
- 查看系统资源：用 free -m 检查可用内存与 Swap，用 top/htop 观察 jenkins 进程的 RES/VIRT 与 CPU 占用，确认是否真的内存瓶颈。
- 查看 Java 堆与元空间：执行 jps 找到 Jenkins 的 PID，再用 jstat -gc 观察 OU/OC/MU/MC 等指标，判断是否堆或元空间吃紧。
- 查看 Jenkins 日志：tail -f /var/log/jenkins/jenkins.log，定位 OutOfMemoryError、插件初始化失败、构建并发过多等线索。
- 检查磁盘空间：df -h，避免因 /var/lib/jenkins 或工作区磁盘满导致异常（常见现象是卡顿、构建失败、日志写入失败）。
二 调整 JVM 堆与元空间大小
- 包安装版常见做法（Ubuntu 常见为 /etc/default/jenkins）：在文件中设置环境变量，例如：
JAVA_ARGS=“-Xms512m -Xmx2048m -XX:MaxMetaspaceSize=512m”
保存后执行 systemctl restart jenkins 生效。
- 若系统同时存在 /etc/sysconfig/jenkins（如部分 Debian/旧版包），可在该文件中设置 JENKINS_JAVA_OPTIONS 或 JAVA_ARGS 调整堆与元空间。
- 容器化部署（Docker）：在 docker run 或 docker-compose.yml 中设置环境变量，例如：
-e JAVA_OPTS=“-Xms512m -Xmx2048m -XX:MaxMetaspaceSize=512m”
注意容器内存上限需大于堆上限并预留给系统与其他进程。
- 参数建议：堆大小一般设为物理内存的 1/2～3/4；元空间按需设置（如 256–512MB）；避免把 Xmx 设置过大导致系统 OOM。修改后重启并观察日志与 jstat 指标是否改善。
三 降低内存占用的架构与配置优化
- 控制并发构建：在 Manage Jenkins → System → 执行者数量（# of executors） 设置为不超过 CPU 核心数（最多不超过 2×CPU 核数），避免并发过多导致堆与线程压力激增。
- 使用构建代理（Agent/节点）：将重型构建（如 Maven/Gradle、Node.js 多进程、Docker-in-Docker）放到专用代理，减轻 Master 负载。
- 精简插件与定期更新：仅保留必要插件，及时更新；避免过时/低效插件拖慢 UI 与构建。
- 清理工作区与归档策略：使用 Workspace Cleanup 插件、构建后清理产物，避免工作区与 $JENKINS_HOME 无限增长。
- 优化 SCM 与检出：如 Git 浅克隆、缓存、并发拉取等，降低每次构建的 I/O 与内存开销。
四 常见场景与对应处理
- 构建时报 OutOfMemoryError（Java heap space）：优先上调 -Xmx，并减少 执行者数量；如仍不足，拆分任务或迁移到代理。
- 启动后很快退出或反复重启：检查系统内存是否不足（free -m）、JVM 参数是否错误、Java 版本是否受支持（Jenkins 2.357+/LTS 2.361.1+ 要求 Java 11 或 17），并查看 /var/log/jenkins/jenkins.log 的具体报错。
- 磁盘空间耗尽导致卡顿/失败：用 df -h 定位大目录（常见为 /var/lib/jenkins/jobs 下构建产物与日志），清理历史构建与归档，必要时扩容磁盘。
- 元空间 OOM（Metaspace）：上调 -XX:MaxMetaspaceSize，并减少/升级占用大的插件，避免类加载泄漏。
五 监控与持续维护
- 建立监控基线：定期记录 free -m、jstat -gc、top/htop 与构建耗时，配合 Java VisualVM/JConsole 远程采样，观察堆、元空间与线程变化。
- 设置告警与自动恢复：当内存使用率或构建失败率异常时告警；必要时用 systemd 的 Restart=always 保障服务自恢复。
- 例行维护：定期更新 Jenkins 与插件、清理工作区与旧构建、审计高开销任务与插件，保持系统在可控资源内稳定运行。
