要让 jenkins 在代码提交后立刻构建并部署，核心是用 webhook 实现“事件驱动”，推荐安装 generic webhook trigger plugin，配置项目触发规则与 git 平台 webhook 地址、密钥、事件类型精准对齐，并验证网络连通性、请求格式及日志报错。
要让 Jenkins 在代码提交后立刻构建并部署，核心是用 Webhook 实现“事件驱动”，而不是靠定时轮询。关键不在 Jenkins 多强大，而在于 Git 仓库、Webhook 地址、Jenkins 项目三者能否精准对齐。
选对插件，接收请求才可靠
推荐安装 Generic Webhook Trigger Plugin，它比原生的 GitHub/GitLab 插件更灵活，支持任意 Git 平台（GitLab、Gitea、Coding 等），也支持自定义参数解析（比如只响应特定分支或标签）。
- 进入 Jenkins → 系统管理 → 插件管理 → 可选插件，搜索并安装 “Generic Webhook Trigger”
- 安装后无需重启，但建议刷新页面确认状态为“已启用”
- 该插件会为每个项目提供独立的触发入口，地址格式统一为：
http://<jenkins-host>:8080/generic-webhook-trigger/invoke</jenkins-host>
配置 Jenkins 项目触发规则
在具体项目的 配置 → 构建触发器 中启用 Generic Webhook Trigger，并设置匹配逻辑：
- 勾选 Trigger builds remotely (e.g., from scripts)，填写一个简单 token（如
deploy-main），用于基础鉴权（可选但推荐） - 再勾选 Generic Webhook Trigger，展开后设置：
- Token：和上面一致，或留空（依赖后续 Git 平台侧的 secret 验证）
-
Filter expression：例如
$.ref == 'refs/heads/main'，确保只响应 main 分支推送 -
Post content parameters：可添加变量如
branch对应$.ref，供后续 Pipeline 脚本使用
在 Git 平台填好 Webhook 地址与事件
以 GitLab 为例，在项目 Settings → Integrations 添加 Webhook：
-
URL：填入 Jenkins 的 invoke 地址，如
http://192.168.1.100:8080/generic-webhook-trigger/invoke -
Secret Token：设一个密钥（如
gitlab-secret-2026），并在 Jenkins 项目中对应位置填入（Generic Webhook Trigger 设置里的 “Secret token” 字段） - Trigger：至少勾选 Push events；如需 PR 合并后触发，再加 Merge Request events
- 保存后点 Test → Push events，观察 Jenkins 构建历史是否出现新条目
验证与排错要点
如果测试失败，优先检查这三项：
- Jenkins 服务器是否能被 Git 平台访问？例如防火墙是否放行 8080 端口，域名是否解析正确
- Webhook 请求是否带了
Content-Type: application/json？Generic 插件默认只接受 JSON 格式 - Jenkins 日志里是否有报错？访问
http://<jenkins>/log/all</jenkins>查看 generic-webhook-trigger 相关输出，常见错误包括 token 不匹配、JSON 解析失败、分支过滤不通过
