Jenkins中使用generic-webhook-trigger能否直接传递完整JSON请求体？

当然可以直接把完整的JSON请求体传给Jenkins任务，无需逐个提取变量，具体实现步骤如下：

1. 在Generic Webhook Trigger中捕获完整JSON #

在Jenkins任务的Generic Webhook Trigger配置页，添加一个变量来抓取整个请求体：

• 变量名可设为PAYLOAD（或自定义名称）
• 表达式填写$（这是JSONPath的根节点表达式，会将完整请求体赋值给该变量）
• 勾选「Post content parameter」选项，确保能捕获原始请求体内容

2. 在Jenkins任务中解析JSON #

拿到PAYLOAD变量后，可通过以下两种常用方式解析：

方式一：Pipeline任务用Groovy脚本解析 #

Groovy原生支持JSON解析，适合Pipeline场景：

pipeline {
    agent any
    stages {
        stage('解析JSON') {
            steps {
                script {
                    def payload = readJSON text: env.PAYLOAD
                    // 示例：提取GitHub事件中的仓库名和分支
                    def repoName = payload.repository.name
                    def branch = payload.ref.split('/').last()
                    echo "仓库名：${repoName}, 分支：${branch}"
                    // 将解析结果转为环境变量供后续步骤使用
                    env.REPO_NAME = repoName
                    env.BRANCH_NAME = branch
                }
            }
        }
    }
}

方式二：Freestyle任务用Shell脚本解析 #

如果是Freestyle任务，可借助jq工具（需在Jenkins节点上提前安装）：

# 提取仓库名
REPO_NAME=$(echo $PAYLOAD | jq -r '.repository.name')
# 提取分支名
BRANCH_NAME=$(echo $PAYLOAD | jq -r '.ref | split("/")[-1]')
# 输出解析结果
echo "仓库：$REPO_NAME, 分支：$BRANCH_NAME"

3. 注意事项 #

• Groovy是Pipeline默认支持的，无需额外安装；jq需要手动在Jenkins节点上部署
• 若JSON内容过大，需确认Jenkins环境变量长度限制，避免内容被截断
• 敏感信息需做加密处理，防止泄露

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