jenkins为何卡在队列

Jenkins 卡在构建队列（Queued）、任务一直不执行，通常是因为没有可用的 executor（执行器）或节点/资源不满足条件。下面按常见原因从“最常见”到“较少见”给你梳理，并给出排查方法。

一、最常见原因

1️⃣ 没有空闲 Executor（执行器）

表现：任务一直显示 pending / queued

原因

• 所有 agent / master 的 executor 都在跑别的任务
• 节点配置的 executor 数量太少

排查

• 打开 Jenkins 首页 → 看 Build Executor Status
• 如果全是 busy，就是没空闲

解决

• 等任务跑完
• 增加 executor 数：
  • 节点管理 → 节点 → 配置 → # of executors
• 或加新 agent 节点

2️⃣ 任务被限制在特定节点，但该节点不可用

表现：任务一直在队列，不报错

原因

• 任务设置了 Restrict where this project can be run
• 目标节点：
  • 离线（offline）
  • 标签不匹配
  • 被临时暂停

排查

• 任务配置 → 看 Label / Node
• 节点管理 → 看节点状态是否为 ✅ Online

解决

• 启动节点
• 修正 label
• 或取消节点限制

3️⃣ 节点离线（Agent Offline）

表现

• 队列卡住
• 节点显示灰色 / offline

常见原因

• agent 进程挂了
• SSH / JNLP 断开
• 网络问题

排查

• Manage Jenkins → Nodes
• 看节点日志

解决

• 重启 agent
• 检查网络 / 防火墙
• 重连 JNLP

二、资源 / 并发限制类原因

4️⃣ 并发构建被限制

表现

• 同项目只能跑 1 个
• 其他在排队

原因

• 任务勾选了：
  • Execute concurrent builds if necessary 未开启
• 或插件限制（如 Lockable Resources）

解决

• 开启并发构建
• 检查资源锁

5️⃣ 被插件“锁”住（Lock / Throttle）

常见插件

• Lockable Resources
• Throttle Concurrent Builds

表现

• 队列中显示 Waiting for lock

解决

• 释放资源锁
• 检查 lock 配置

三、系统级问题

6️⃣ Jenkins Master 卡死 / 假死

表现

• 页面响应慢
• 所有任务都不动

排查

• 看 Jenkins 进程 CPU / 内存
• 看 jenkins.log

解决

• 重启 Jenkins
• 优化内存（-Xmx）

7️⃣ 磁盘满

表现

• 构建突然全卡住
• 日志写不进去

解决

df -h

清理 /var/lib/jenkins 或 workspace

四、快速自查清单 ✅

你可以按顺序看：

1. Build Executor Status 是否满
2. 节点是否 Online
3. 任务是否限制了 Node/Label
4. 是否有 Lock / 并发限制
5. Jenkins 日志有没有报错
6. 磁盘 / 内存是否正常

如果你愿意，可以告诉我：

• Jenkins 版本
• 是 Master 还是 Agent 卡住
• 队列里的提示文字（如 Waiting for next available executor）

我可以直接帮你定位是哪一种。