Jenkins Agent JNLP4连接故障：特定任务结束时无法对接Controller求助

根因定位 #

你遇到的异常并非Jenkins Agent与Controller的连接故障，是任务配置的Console output (build log) parsing（日志解析插件）规则存在语法错误，触发Java正则编译失败，直接中断构建流程，表面呈现为Agent向Controller交接任务时失败。
核心报错点：正则表达式e:\jenkbuilds\(.+)\builds/[0-9]+(/.*)?中，Windows路径的反斜杠\属于正则特殊控制字符，未做正确转义触发PatternSyntaxException，导致构建被标记为失败。
其余任务运行正常的原因：其他任务未配置该存在语法错误的日志解析规则，因此不会触发该异常，和Agent网络、连接配置无关联。

解决方案 #

• 定位错误配置：进入对应故障任务的配置页面，找到构建后操作分类下的「Console output (build log) parsing」配置项，定位包含e:\jenkbuilds路径的自定义匹配规则。
• 修正正则转义：Java正则中Windows路径的反斜杠需要双重转义，将原规则内所有\替换为\\\\，修正后的规则应为e:\\\\jenkbuilds\\\\(.+)\\\\builds/[0-9]+(/.*)?；如果需要兼容跨平台路径，也可以将反斜杠替换为[\\\\/]，同时适配Windows和Linux的路径分隔符。
• 验证生效：保存配置后重新执行任务即可，无需重启Jenkins Controller或Agent节点。
• 兜底方案：如果无需使用日志解析功能，直接删除该构建后步骤即可立即解决问题。

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