Jenkins 配置 Webhook 触发自动化构建需三步：安装对应平台插件（如 GitHub/GitLab/Gitee 插件及 Build Authorization Token Root）、在项目中配置触发器并生成 Webhook URL、在代码仓库填写该 URL 和 Token 并启用事件。
Jenkins 配置 Webhook 触发自动化构建，核心是让代码仓库（如 GitHub、GitLab、Gitee）在发生事件（如 push、PR、tag）时，主动通知 Jenkins 启动构建。它比轮询 SCM 更及时、更节省资源。
确认并安装必要插件
不同 Git 平台对应不同插件，需按实际环境选择：
- GitHub：安装 GitHub plugin 或 GitHub Integration Plugin
- GitLab：安装 GitLab Plugin 或 Generic Webhook Trigger（更灵活，支持自定义参数）
- Gitee：安装 Gitee Plugin
- 通用增强：安装 Build Authorization Token Root Plugin（用于免登录触发，尤其配合 token 方式）
安装后建议重启 Jenkins，确保插件生效。
配置 Jenkins 项目触发器
进入具体项目的「配置」→「构建触发器」部分：
- 若使用官方插件（如 Gitee Plugin），勾选 “Gitee webhook 触发构建”，系统会自动生成 Webhook URL 和密码，务必复制保存；
- 若使用 Generic Webhook Trigger，勾选该触发器，可设置 JSON Path 提取分支名、commit ID 等，并支持正则过滤（例如只触发
main-.*分支）； - 勾选对应事件：如“推送代码”、“新建 Pull Requests”、“创建 Tag”等；
- 建议启用 “过滤已经构建的 Commit 版本”，避免重复构建；
- 如需多分支响应，勾选 “允许所有分支触发构建” 或按需填写分支表达式。
在代码仓库中配置 Webhook
以 GitLab 为例（其他平台路径类似）：
- 进入项目 → Settings → Integrations → Add webhook；
-
Payload URL 填写 Jenkins 生成的地址，例如：
http://your-jenkins-ip:8080/project/your-job-name（Gitee 插件）
或http://your-jenkins-ip:8080/generic-webhook-trigger/invoke（Generic 插件）； - Secret Token（如有）填 Jenkins 中生成的密码或自定义 token；
- 勾选触发事件，常见为 Push events、Merge Request events；
- 取消勾选 Enable SSL verification（测试环境无 HTTPS 时）；
- 点击 Add webhook 保存。
验证与调试要点
配置完成后，关键一步是验证是否真正打通：
- 在 Git 仓库页面点击 Test 按钮（如 “Test push”），观察 Jenkins 是否立即开始构建；
- 检查 Jenkins 构建日志开头是否有 Started by remote host 或 Started by GitLab push by 等标识；
- 若失败，查看 Jenkins 系统日志（Manage Jenkins → System Log）和 Git 仓库 Webhook 的响应详情（含 HTTP 状态码、错误信息）；
- 确保 Jenkins 服务器能被 Git 仓库服务器网络访问（端口开放、防火墙放行、DNS 可解析）；
- 注意：Webhook URL 中的路径区分大小写，job 名称必须完全匹配。
