Jenkins管道执行遇ChannelClosedException问题求助（JNLP Windows代理）

异常信息 #

Caused: hudson.remoting.ChannelClosedException: Channel “hudson.remoting.Channel@3f4ae533:JNLP4-connect connection from X.X.X.X/X.X.X.X:44909”: Remote call on JNLP4-connect connection from X.X.X.X/X.X.X.X:44909 failed. The channel is closing down or has closed down

排查与修复步骤 #

• 重启Windows代理节点
  直接终止代理进程或重启Windows代理服务，不要只重启Jenkins主节点，确保代理重新建立与主节点的连接。
• 验证网络与防火墙
  在代理节点ping Jenkins主节点IP，确认网络连通；检查主、代理节点的防火墙规则，确保JNLP默认端口（50000）或自定义端口未被拦截，可临时关闭防火墙测试。
• 重新生成代理JNLP文件
  从Jenkins主节点重新下载代理的JNLP文件，替换代理端旧文件后重启代理，避免旧配置失效。
• 检查代理资源状态
  查看Windows代理的CPU、内存、磁盘占用，确认是否因资源耗尽导致进程崩溃，清理磁盘或扩容资源。
• 调整Remoting插件版本
  Jenkins 2.356适配的Remoting插件版本若存在兼容性问题，可降级到4.11版本（稳定适配版），或升级至对应兼容版本。
• 修改JNLP启动参数
  在代理启动命令中添加参数：
  • -D hudson.remoting.JNLP4ConnectionReadTimeout=600000 延长连接超时时间
  • -D hudson.remoting.Channel.pingInterval=30 增加心跳频率，降低网络波动导致的断开概率
• 查看主节点详细日志
  检查Jenkins主节点的logs/remoting.log，获取连接断开的具体原因（如SSL证书、权限错误等）。

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