怎样排查Jenkins运维故障

排查 Jenkins 运维故障，一般遵循**“由外到内、分层定位”的思路：先看服务是否活着，再看日志，再排查任务/插件/权限/资源等问题。下面给你一套实用排查清单**。

一、先确认服务状态（最基础）

1. Jenkins 是否运行

systemctl status jenkins
# 或
ps -ef | grep jenkins

如果没运行：

systemctl start jenkins
journalctl -u jenkins -n 100

2. 端口与访问

ss -lntp | grep 8080
curl -I http://localhost:8080

• 访问不了：防火墙、反向代理（Nginx）、端口冲突
• 502/503：Jenkins 进程挂了或启动中

二、看日志（最关键）

1. Jenkins 主日志

# 系统日志
/var/log/jenkins/jenkins.log

# 或
journalctl -u jenkins -f

重点看：

• OutOfMemoryError
• Permission denied
• Failed to start
• plugin failed

三、Web 页面异常排查

1. 页面打不开 / 白屏

可能原因：

• Jenkins 未启动
• 内存不足（OOM）
• 插件损坏
• Nginx / Apache 反向代理配置错误

可尝试：

systemctl restart jenkins

2. 登录异常

• 管理员密码丢失：

cat /var/lib/jenkins/secrets/initialAdminPassword

• 用户权限异常：检查 config.xml 中 <authorizationStrategy>

四、Job / Pipeline 故障

1. 构建卡住

常见原因：

• Agent 离线
• 节点磁盘满
• 脚本死循环
• 并发数满

检查：

df -h
free -m

Jenkins → 节点管理 → 看 Agent 状态

2. 构建失败但无日志

• 看 Console Output
• 看 Agent 上日志
• 检查 workspace 权限

五、插件问题（高频故障）

1. 插件冲突 / 升级失败

• 进入：Manage Jenkins → Plugins
• 查看报错插件
• 安全模式启动（禁用插件）：

systemctl stop jenkins
# 删除或重命名问题插件
rm /var/lib/jenkins/plugins/xxx.hpi
systemctl start jenkins

六、资源问题（运维最容易忽略）

1. 磁盘满

df -h
du -sh /var/lib/jenkins/*

清理：

• 旧构建
• workspaces
• 归档文件

2. 内存不足

free -m

调整：

/etc/default/jenkins
# 或
/etc/sysconfig/jenkins

改：

JAVA_OPTS="-Xmx2g"

七、权限 & 文件问题

1. Jenkins 用户

ps -ef | grep jenkins
id jenkins

常见问题：

• 用 root 启动后权限混乱
• workspace 无法写入

修复：

chown -R jenkins:jenkins /var/lib/jenkins

八、备份与恢复（故障兜底）

备份核心目录

/var/lib/jenkins

包含：

• jobs
• users
• plugins
• config.xml

九、常见故障速查表

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

• Jenkins 版本
• 操作系统
• 具体报错日志或现象

我可以帮你精准定位某一个故障。