CloudBees Jenkins Distribution 2.277.4.3 配置系统页点击保存/应用无响应

使用版本为2.277.4.3的CloudBees Jenkins Distribution时，修改系统配置设置时无法正常保存或应用更改，复现步骤如下：

• 使用任意浏览器访问https://<jenkins_ui>/configure页面
• 对配置项进行任意修改
• 点击「Apply」或「Save」按钮时无任何响应，修改内容未生效保存

修复方案 #

1. 前端资源冲突/缓存问题处理 #

该版本存在静态资源缓存失效的已知问题，优先执行以下操作：

• 强制刷新浏览器缓存：Windows系统按Ctrl+Shift+R，Mac系统按Cmd+Shift+R，刷新后重新尝试保存
• 禁用浏览器所有扩展插件后重试，广告拦截、脚本拦截类插件大概率会拦截Jenkins的配置提交请求
• 切换至浏览器隐私/无痕模式访问Jenkins，排除本地缓存、Cookie冲突的影响

2. CSRF保护配置异常处理 #

该版本默认的跨站请求伪造（CSRF）保护配置存在偶发失效问题，可按以下步骤验证修复：

1. 登录Jenkins部署主机，修改启动配置文件：Windows环境修改jenkins.xml，Linux环境修改/etc/sysconfig/jenkins
2. 在JVM启动参数中添加临时配置：-Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true
3. 重启Jenkins服务后重新尝试保存配置，注意：验证问题解决后请立刻移除该参数，恢复CSRF保护避免安全风险
   确认是CSRF导致的问题后，升级CSRF相关插件到兼容该版本的最新版即可永久修复。

3. 隐藏配置项校验失败处理 #

该版本部分配置项校验失败时不会弹出前端提示，表现为点击保存按钮无响应：

• 按下F12打开浏览器开发者工具，切换到「控制台」标签，点击保存按钮后查看是否存在JS报错、校验失败提示
• 重点检查全局凭据、邮件服务器、SSH远程站点等配置的必填字段，确认不存在空值、格式错误问题，修正后重新提交

4. 本地写入权限问题处理 #

Jenkins配置需要写入本地根目录下的config.xml文件，可检查以下两项：

• Jenkins运行账号是否拥有Jenkins根目录的读写权限
• Jenkins根目录所在磁盘剩余空间是否充足，空间不足会导致配置写入静默失败

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