Jenkins LTS重启后出现插件循环依赖错误，服务无法启动求助

问题描述 #

重启Jenkins LTS 2.303.3实例（通过JCaSC插件自动重装所有插件）后，Jenkins无法正常启动，日志中出现如下循环依赖错误：

2022-07-27 17:59:00.565+0000 [id=31] SEVERE hudson.PluginManager$1$3$2$1#reactOnCycle: found cycle in plugin dependencies: (root=Plugin:sshd, deactivating all involved) Plugin:sshd -> Plugin:mina-sshd-api-core -> Plugin:ssh-credentials -> Plugin:credentials -> Plugin:configuration-as-code -> Plugin:sshd
2022-07-27 17:59:00.569+0000 [id=31] SEVERE hudson.PluginManager$1$3$2$1#reactOnCycle: found cycle in plugin dependencies: (root=Plugin:sshd, deactivating all involved) Plugin:sshd -> Plugin:mina-sshd-api-core -> Plugin:ssh-credentials -> Plugin:credentials -> Plugin:configuration-as-code -> Plugin:sshd
2022-07-27 17:59:00.570+0000 [id=31] SEVERE hudson.PluginManager$1$3$2$1#reactOnCycle: found cycle in plugin dependencies: (root=Plugin:sshd, deactivating all involved) Plugin:sshd -> Plugin:mina-sshd-api-core -> Plugin:ssh-credentials -> Plugin:credentials -> Plugin:configuration-as-code -> Plugin:trilead-api -> Plugin:sshd

未修改过任何插件版本，问题由自动重装时的版本冲突导致。

解决步骤 #

1. 临时禁用冲突插件，启动Jenkins #

• 找到Jenkins的插件目录（默认路径为$JENKINS_HOME/plugins）
• 将以下插件的.jpi/.hpi文件重命名（添加.disabled后缀）：
  • sshd
  • mina-sshd-api-core
  • ssh-credentials
  • credentials
  • configuration-as-code
  • trilead-api
• 重启Jenkins，此时Jenkins会以基础功能启动

2. 修复插件依赖，重新启用 #

• 进入Jenkins后台「Manage Jenkins」→「Manage Plugins」→「Updates」标签
• 优先更新configuration-as-code（JCaSC）和sshd插件，这两个是循环链的核心节点
• 按顺序重新安装并启用插件：credentials → ssh-credentials → mina-sshd-api-core → trilead-api → sshd → configuration-as-code
• 重启Jenkins验证启动状态

3. 锁定插件版本，避免后续自动冲突 #

在JCaSC配置文件中明确指定兼容Jenkins LTS 2.303.3的插件版本，示例配置：

jenkins:
  plugins:
    - "credentials:2.6.1"
    - "ssh-credentials:1.19.2"
    - "mina-sshd-api-core:2.8.0"
    - "trilead-api:1.0.13"
    - "sshd:3.1.0"
    - "configuration-as-code:1.55"

锁定版本后，JCaSC自动重装时会使用指定的兼容版本，避免再次出现循环依赖。

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