Jenkins集成Bitbucket时bitbucket-hook触发出现Network Error如何解决

可行解决方案 #

• 首先验证端口转发有效性：使用脱离当前局域网的设备（比如关闭WiFi的手机）访问http://<你的公网IP>:8080，确认能正常打开Jenkins登录页。如果无法访问，优先排查两项配置：
  1. 路由器端口转发规则是否正确将公网8080端口的TCP请求转发到运行Jenkins的Windows设备的内网IP对应端口
  2. Windows系统防火墙、第三方安全软件是否开放了8080端口的入站访问权限
• 检查webhook地址格式：确认Bitbucket中填写的webhook地址末尾必须带斜杠，即完整格式为http://<公网IP>:8080/bitbucket-hook/，缺失末尾斜杠会被Jenkins Bitbucket插件拦截返回404，触发网络错误提示。
• 调整Jenkins安全配置：进入Jenkins全局安全设置页面，临时关闭跨站请求伪造（CSRF）保护后重新测试，确认是否是CSRF规则拦截了Bitbucket的公网请求。同时确认安装的Bitbucket插件版本适配Jenkins 2.303.1，版本不兼容也会导致接口异常。
• 更换端口规避运营商封禁：国内运营商普遍封禁8080、80、443等常用端口，可尝试将Jenkins服务端口修改为10000以上的冷门端口，重新配置端口转发和webhook地址后测试。
• 替换HTTPS协议测试：Bitbucket云服务默认要求webhook地址使用HTTPS协议，纯HTTP地址会被主动拦截。可使用内网穿透工具临时生成HTTPS公网地址，替换原有webhook地址测试是否可正常触发回调。

内容的提问来源于stack exchange，提问作者Bishal Basak Papan