问题描述如下

目前公司的Jenkins 版本：2.305（暂时无法升级），近期安装插件——这里仅以Email Extension Plugin（artifactId: email-ext）为例，遇到不兼容问题，如下图所示：

问题原因:显然是通过jenkins自动下载的插件版本与当前的jenkins版本不兼容导致！

那么解决方案只有：手动下载并安装兼容的历史版本

思路如下 

第一步：确认的 Jenkins 版本发布时间

• 通过下面的链接获取Jenkins 2.305 发布时间大概为：2021-07-22 

https://get.jenkins.io/war/

• 这意味着应该优先考虑 2021 年中之前或稍后发布的Email Extension Plugin插件版本

第二步：查找插件的发布历史和兼容性

访问插件官网 

1. 打开插件主页
   https://plugins.jenkins.io/email-ext/releases/
2. 滚动到符合标准的历史版本，例如 2.83，用压缩工具（如 7-Zip）打开 .hpi 文件。查看 META-INF/MANIFEST.MF 文件内容，找到信息如下：

Jenkins-Version: 2.222.4

这个值 ≤ 2.305，证明兼容。

第三步：下载对应版本的 .hpi 文件

直接下载插件 email-ext： https://updates.jenkins-ci.org/download/plugins/email-ext/

第四步：手动上传安装插件

1. 登录 Jenkins
2. 进入 Manage Jenkins > Manage Plugins
3. 切换到 “Advanced” 标签页
4. 在 “Upload Plugin” 区域，选择你下载的 .hpi 文件
5. 点击 Upload
6. 安装完成后，根据提示 重启 Jenkins

如果提示缺少依赖插件获取与其他插件不兼容，同样需要手动下载对应历史版本安装。

 自动化建议（批量处理）

如果你经常需要为旧版 Jenkins 安装插件，可以：

1. 建立本地插件仓库：把已验证兼容的 .hpi 文件存档
2. 使用 Jenkins CLI 或脚本批量安装：

   1java -jar jenkins-cli.jar -s http://your-jenkins/ install-plugin /path/to/email-ext.hpi

 总结流程（通用模板）

步骤	操作
1️⃣	确认 Jenkins 版本及发布时间
2️⃣	查找目标插件的 GitHub Releases 或 plugin site
3️⃣	找到满足 Minimum-Jenkins-Version ≤ 你的版本 的最高插件版本
4️⃣	从 updates.jenkins-ci.org 下载对应 .hpi
5️⃣	在 Jenkins “Advanced” 页面手动上传安装
6️⃣	处理依赖插件（重复上述过程）