Jenkins Freestyle任务无法在HTTP请求Body中传递构建参数求助

算力阿峰

2026-6-13

问题：Jenkins HTTP POST请求Body无法传递构建参数

我遇到了Stack Overflow上一个未解决的同类问题——无法在Jenkins的HTTP POST请求Body中传递构建参数。尝试过${env.my_param}、${my_param}、${params.my_param}等多种写法，均无法读取并应用参数。

相关配置界面如下：
HTTP请求配置界面
参数写法尝试界面

用Groovy脚本生成请求体
在HTTP请求插件的"Request Body"选择"Script"类型，通过Groovy脚本动态生成包含参数的Body，示例代码：
```
return """
{
  "targetKey": "${params.my_param}",
  "anotherKey": "${env.BUILD_NUMBER}"
}
"""
```
这种方式能确保构建参数被正确解析替换。
先确认参数是否存在于构建上下文
在HTTP请求步骤前添加"Execute shell"步骤，打印参数值确认是否传入：
```
echo "my_param的值：${my_param}"
echo "env.my_param的值：${env.my_param}"
```
如果打印为空，说明参数未正确传入构建，需要检查项目是否勾选了"This project is parameterized"，以及参数名称是否拼写一致。
借助EnvInject插件注入环境变量
安装EnvInject插件后，在构建前将参数注入环境变量，之后在请求Body中用${ENV,var="my_param"}格式引用参数。
改用curl命令替代HTTP插件
如果插件解析有问题，直接用shell步骤执行curl命令，示例：
```
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"paramKey":"'"${my_param}"'"}' \
  https://你的目标接口地址.com
```
注意引号的转义，确保参数正确嵌入请求体。