Jenkins安装Credentials插件时SHA-256校验不匹配报错如何解决

报错原因 #

该报错为Jenkins插件安装阶段的校验和校验失败，下载得到的Credentials插件临时文件与官方发布的对应版本文件哈希值不匹配，通常由三类问题导致：网络波动导致下载文件不完整、插件镜像站点缓存未及时更新、当前Jenkins核心版本与最新版Credentials插件不兼容。

解决方案 #

• 清理残留损坏文件
  登录Jenkins部署的服务器，执行以下命令删除损坏的临时下载文件：

  rm -f /var/lib/jenkins/plugins/credentials.jpi.tmp
  

  清理完成后先重试一次自动安装，确认是否恢复。
• 更换插件更新源
  进入Jenkins后台→管理Jenkins→插件管理→高级设置，将默认的官方升级站点地址替换为国内稳定的Jenkins插件镜像源，保存配置后重试安装。
• 手动上传安装插件
  若自动安装持续失败，可自行下载与当前Jenkins版本兼容的Credentials插件安装包（.jpi格式），在插件高级设置页面找到上传插件入口，选择本地安装包上传，安装完成后重启Jenkins即可生效。
• 适配Jenkins核心版本
  以上操作均无效时，可确认当前Jenkins核心版本是否符合最新Credentials插件的最低要求，要么升级Jenkins核心版本，要么下载对应兼容的旧版Credentials插件手动安装。

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