Jenkins执行npm install时崩溃，持续构建失败问题排查求助
从你描述的这些症状——Jenkins构建静默崩溃、npm install奇慢且服务器卡顿、KeystoneJS项目随问题出现崩溃、Express项目却正常，甚至SSH连接偶尔失效——来看，核心大概率是服务器资源过载或者资源竞争引发的连锁问题，咱们一步步拆解可能的原因和排查方向：
1. 服务器内存/CPU资源耗尽（最核心的嫌疑）
Jenkins构建+Jest测试本身就会占用不少CPU和内存，再加上另外两个Node.js项目，尤其是KeystoneJS（它依赖数据库、可能有后台任务/定时任务，资源占用天生比纯Express项目高），当系统资源被挤到临界值时，Linux会触发OOM Killer（内存不足杀手），直接杀掉占用资源最高的进程来自保——这就会导致Jenkins突然崩溃、KeystoneJS被干掉，甚至SSH都连不上（因为SSH进程也抢不到系统资源）。
排查步骤：
- 实时监控资源：用
top或htop命令，在Jenkins构建时盯着CPU、内存、Swap的使用率，如果内存接近100%或者Swap被大量占用，基本就能实锤。 - 查系统日志：查看
/var/log/syslog（Debian/Ubuntu）或/var/log/messages（CentOS/RHEL），找包含Out of memory: Killed process的日志，确认是不是OOM Killer在搞事情。 - 调整Jenkins内存：默认的Jenkins JVM内存分配可能不够，修改
JENKINS_JAVA_OPTIONS参数（比如在/etc/default/jenkins里），增加堆内存，例如-Xmx2g（根据服务器实际配置调整，别超过物理内存的70%）。
2. KeystoneJS项目的资源泄漏/异常占用
为什么KeystoneJS会崩溃而Express项目没事？很大可能是KeystoneJS存在内存泄漏、未处理的异步任务，或者新增的代码（比如定时任务、低效数据库查询）导致资源占用持续飙升。当Jenkins构建开始抢资源时，它就成了第一个扛不住的“软柿子”。
排查步骤：
- 监控进程资源：如果用PM2管理Node进程，直接用
pm2 monit查看KeystoneJS的内存/CPU使用趋势，看是否有持续上涨不回落的情况；也可以用node --inspect连接进程，通过Chrome DevTools分析内存快照。 - 回溯代码变更：检查KeystoneJS最近的代码改动，有没有新增定时任务、批量数据库操作，或者更新了依赖包——某些依赖包的bug也可能导致资源泄漏。
- 给Node进程设内存上限：启动KeystoneJS时加上
--max-old-space-size=1024（限制为1GB内存），避免单个进程吃光所有内存。
3. Jenkins构建的资源隔离缺失
默认情况下，Jenkins是直接在主机上运行构建任务，和其他Node项目共享所有资源，没有任何隔离。如果Jenkins的构建任务（比如npm install+Jest测试）突然占用大量资源，就会直接影响其他服务的运行。
排查步骤：
- 限制Jenkins并发构建：在Jenkins全局配置里，把“最大并发构建数”设为1，避免多个构建任务同时抢资源。
- 用容器隔离构建：把Jenkins的构建任务放到Docker容器里运行，给容器分配固定的CPU/内存配额，比如
docker run --cpus=1 --memory=2g ...，彻底隔离构建任务和其他服务的资源。
4. 磁盘IO瓶颈
npm install速度极慢且服务器卡顿，也可能是磁盘IO被占满导致的——Jenkins构建时要大量读写node_modules，KeystoneJS同时在读写数据库，两者抢IO资源，导致整个系统响应变慢。
排查步骤：
- 检查磁盘IO：用
iostat -x 1命令，看%util列的数值，如果接近100%，说明磁盘IO已经饱和。 - 检查磁盘空间：用
df -h查看各个分区的使用率，尤其是Jenkins工作目录、KeystoneJS的数据库存储目录，别让磁盘满了。 - 优化npm：给npm配置本地缓存（
npm config set cache /path/to/larger-disk），或者换用pnpm，它的依赖存储更高效，能减少磁盘IO和占用。
5. 系统层面的限制或异常
偶尔连不上SSH，可能是服务器的进程数达到上限，或者网络栈被占满了。比如当系统进程太多时，新的SSH连接请求无法创建新进程；或者大量TIME_WAIT连接占用了端口资源。
排查步骤：
- 检查进程数限制：用
ulimit -u查看当前用户的最大进程数，如果接近上限，修改/etc/security/limits.conf调高限制（比如* soft nproc 65535）。 - 检查网络连接：用
netstat -anp查看网络状态，看是否有大量TIME_WAIT或ESTABLISHED的连接，必要时调整TCP参数优化连接回收。
快速验证方法
先临时停掉KeystoneJS项目，再跑一次Jenkins构建，如果此时构建正常、npm install速度恢复，那基本可以确定是资源竞争导致的问题，再针对性优化资源分配即可。
内容的提问来源于stack exchange，提问作者Olivier Van Bulck
