GitHub无法触发Jenkins任务排查：Webhook推送失败，curl可正常触发

嘿，既然你用终端的curl命令能成功触发Jenkins任务，说明你的Jenkins任务token、用户权限这些核心配置都是没问题的。那GitHub Webhook提示无法交付但没给出具体错误，大概率是GitHub到Jenkins的网络连通性或者Jenkins的Webhook接收配置出了问题，咱们一步步排查解决：

一、先确认Jenkins能被GitHub的服务器访问 #

你自己能从手机电脑访问Jenkins不代表GitHub的服务器能访问——很多云服务器的安全组、防火墙只会放行特定IP（比如你自己的），得确保：

• 用端口检测工具（比如本地终端敲telnet MY_Jenkins_server_public_IP 8080，或者用在线端口检测）验证8080端口对外部公网开放。
• 如果Jenkins是在局域网内做端口映射出来的，检查路由器的端口转发规则是否正确，有没有拦截外部请求。

二、配置Jenkins接收GitHub Webhook的正确姿势 #

1. 装对插件：确保Jenkins已经安装了GitHub Integration或者GitHub插件——这是Jenkins能识别GitHub Webhook的基础，没装的话去Manage Jenkins -> Plugins里搜索安装。
2. 临时关闭CSRF保护测试：
   Jenkins默认开着CSRF保护，很可能会拦截GitHub的Webhook请求。你可以先去Manage Jenkins -> Configure Global Security，找到CSRF Protection暂时取消勾选，然后测试Webhook能不能触发。如果能，之后再配置GitHub IP白名单或者CSRF令牌的正确传递方式，不用一直关着。
3. 给任务开Webhook触发开关：
   进入你的Jenkins任务，点Configure -> Build Triggers，一定要勾选GitHub hook trigger for GITScm polling——这一步是告诉Jenkins：“收到GitHub的Webhook事件时，触发我这个任务的构建”。

三、配置GitHub仓库的Webhook #

这里很多人容易踩坑，别用你curl的那个地址！GitHub Webhook需要用Jenkins专门的接收端点：

1. 打开你的GitHub仓库，点Settings -> Webhooks -> Add webhook。
2. Payload URL：填http://MY_Jenkins_server_public_IP:8080/github-webhook/（注意最后必须有斜杠！少了这个斜杠十有八九会失败）。
3. Content type：选application/json，别选默认的表单格式。
4. Secret（可选但推荐）：设置一个自定义密钥，然后去Jenkins的Manage Jenkins -> Configure System -> GitHub里，添加GitHub服务器，把这个密钥存成Secret text类型的凭证，勾选Manage hooks——这样能防止恶意请求触发你的Jenkins任务。
5. 触发事件：选Just the push event（或者你需要的事件，比如PR合并），然后点Add webhook。

四、测试&排查 #

配置完后，去GitHub的Webhook页面，点Recent deliveries，选最新的一条点Redeliver，然后看结果：

• 如果还是提示无法交付，去Jenkins看系统日志：Manage Jenkins -> System Log，找有没有Webhook相关的报错——比如权限拦截、端口不通、CSRF拒绝之类的，日志会告诉你具体问题。
• 如果Jenkins日志显示收到请求但没触发构建，回去检查任务的Build Triggers是不是真的勾了GitHub hook trigger for GITScm polling，还有任务的SCM配置是不是和GitHub仓库对应上了。

五、网络不通的替代方案 #

要是你的Jenkins服务器实在没法被公网访问（比如在公司内网），可以用GitHub Actions当中间跳板：

1. 在GitHub仓库的.github/workflows目录下新建一个trigger-jenkins.yml文件。
2. 把你的Jenkins用户名、token存在GitHub仓库的Secrets里（比如命名为JENKINS_USER和JENKINS_TOKEN），然后写一个简单的工作流，用curl调用你原来的Jenkins构建地址：

   name: Trigger Jenkins Build
   on: [push]
   jobs:
     trigger:
       runs-on: ubuntu-latest
       steps:
         - name: Call Jenkins Build API
           run: |
             curl -X POST "http://${{ secrets.JENKINS_USER }}:${{ secrets.JENKINS_TOKEN }}@MY_Jenkins_server_public_IP:8080/job/JOBNAME/build?token=MyTocken"
   

   这样每次GitHub有push事件，GitHub Actions就会在公网环境里帮你触发Jenkins任务，完美绕过网络限制。

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