Jenkins从2.364升级至2.375后无法启动，报错未识别选项--handlerCountMax=100

问题原因 #

Jenkins 2.375版本更新了底层依赖的Winstone servlet容器，该版本移除了--handlerCountMax这个启动参数，而你的启动配置中仍保留了这个参数，导致启动时触发参数不识别错误。

修复步骤 #

• 定位Jenkins的启动配置文件：
  • Windows系统通常是jenkins.xml（默认路径C:\Program Files\Jenkins\jenkins.xml）
  • Linux系统如果用systemd管理，是/etc/systemd/system/jenkins.service；如果是自定义启动脚本，找到对应的脚本文件
• 打开配置文件，找到包含--handlerCountMax=100的启动参数行，删除该参数
• 保存配置后，重新启动Jenkins服务

额外说明 #

如果启动参数是通过Jenkins控制台的全局配置（如“管理Jenkins”→“系统配置”中的启动参数）设置的，也需要进入对应页面移除--handlerCountMax=100这一项。

内容的提问来源于stack exchange，提问作者Max de Graaf