Jenkins升级后GitHub插件加载失败，Git服务器及作业无法正常显示

启动Jenkins时，GitHub插件出现如下报错：

WARNING hudson.model.Descriptor#load: Failed to load /var/lib/jenkins/github-plugin-configuration.xml
com.thoughtworks.xstream.mapper.CannotResolveClassException: github-plugin-configuration
at com.thoughtworks.xstream.mapper.DefaultMapper.realClass(DefaultMapper.java:81)
Caused: java.io.IOException: Unable to read /var/lib/jenkins/github-plugin-configuration.xml
at hudson.XmlFile.unmarshal(XmlFile.java:199)

相关版本信息：

• Jenkins版本：2.387.1
• GitHub插件版本：1.37.0

当前github-plugin-configuration.xml内容：

<?xml version='1.1' encoding='UTF-8'?>
<github-plugin-configuration plugin="github@1.37.0">
  <configs/>
</github-plugin-configuration>

此外，作业已放置在/var/lib/jenkins/jobs目录中，但Jenkins界面无法查看任何作业。

已尝试的操作：

• 重启Jenkins
• 确认$JENKINS_HOME环境变量配置正确，除GitHub插件外其他插件均正常加载，暂不确定作业无法加载是否由该插件导致
• 确认GitHub插件的所有依赖均已安装
• 找到过一个针对该问题的修复方案，但因未安装Support Core插件无法使用

解决方案 #

1. 修复GitHub插件配置文件 #

该报错是XStream无法解析配置文件的根节点类名，大概率是插件版本更新后配置类结构变化导致。操作步骤：

• 停止Jenkins服务
• 将/var/lib/jenkins/github-plugin-configuration.xml重命名为github-plugin-configuration.xml.bak做备份
• 重新启动Jenkins，插件会自动生成符合当前版本的新配置文件

2. 排查作业无法加载问题 #

如果插件问题解决后作业仍不显示，按以下步骤排查：

• 检查作业目录权限：确保Jenkins进程所属用户（一般是jenkins）拥有/var/lib/jenkins/jobs目录的读写权限，执行命令：

  sudo chown -R jenkins:jenkins /var/lib/jenkins/jobs
  sudo chmod -R 755 /var/lib/jenkins/jobs
  

• 查看Jenkins日志：在/var/log/jenkins/jenkins.log中搜索Failed to load job等关键词，定位具体的作业加载错误
• 测试新建作业：创建一个简单的测试作业，验证是否能正常显示，排查是批量导入的作业有问题还是全局加载机制故障

3. 适配插件与Jenkins版本 #

Jenkins 2.387.1是较新的LTS版本，检查插件兼容性：

• 升级GitHub插件到官方标注的兼容最新版本（建议先停止Jenkins再升级，避免中途出错）
• 如果升级后问题依旧，尝试降级到与当前Jenkins版本匹配的稳定版GitHub插件

内容的提问来源于stack exchange，提问作者Pexers