Jenkins 2.387.1报CpsCompilationErrorsException，参数错误求解决方案

核心原因 #

你的错误本质是kubernetes相关插件版本与Jenkins 2.387.1不兼容，导致kubernetesDeploy步骤的参数定义发生了变化：

• 在Jenkins 2.289.3对应的旧版插件中，kubernetesDeploy支持hccEnv参数；
• 升级到Jenkins 2.387.1后，你使用的kubernetesDeploy插件（或其依赖插件）已经移除/重命名了hccEnv参数，日志里提示的ssh是当前版本支持的参数，进一步验证了这一点。

workflow-cps-global-lib-plugin是用于管理全局流水线库的插件，和这个参数错误无关，所以安装它无法解决问题。

解决方案 #

1. 调整流水线代码适配新插件参数 #

查看当前kubernetesDeploy插件的详情（Jenkins插件管理页面内），找到替代hccEnv的参数。根据日志提示，可先尝试将hccEnv替换为ssh，或对应功能的其他新参数：

// 旧代码
kubernetesDeploy(hccEnv: 'd')

// 示例修改（以实际插件支持的参数为准）
kubernetesDeploy(ssh: 'd')

2. 降级kubernetes相关插件到兼容版本 #

如果不想修改流水线代码，可查找适配Jenkins 2.387.1且仍支持hccEnv参数的插件版本：

• 进入Jenkins插件管理→已安装，找到提供kubernetesDeploy步骤的插件（通常是Kubernetes Continuous Deploy）；
• 点击降级，选择一个在Jenkins 2.387.1环境下仍支持hccEnv参数的旧版本，安装后重启Jenkins测试。

3. 检查插件依赖兼容性 #

Jenkins 2.387.1作为较新的LTS版本，对插件最低版本要求更高，需确认以下插件版本满足适配要求：

• Kubernetes插件
• Kubernetes Continuous Deploy插件
• Pipeline: Nodes and Processes插件

确保这些插件都升级到适配Jenkins 2.387.1的最新兼容版本，避免依赖冲突。

额外说明 #

Jenkins不同LTS版本间的插件兼容性差异是常见问题，尤其是流水线步骤参数的变更。升级Jenkins时，建议先查看官方升级指南和插件更新日志，提前排查可能的参数或API变更。

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