Jenkins远程API调用能否传输大体积JSON请求体触发构建任务？

• 执行curl报--data-urlencode: command not found，本质是两个原因：要么curl版本低于7.18.0（该版本才首次加入--data-urlencode参数），要么参数位置写错，把--data-urlencode写在了URL之后，被shell当成独立命令执行。
• 用--data提交后无响应、任务不触发，是因为请求不符合Jenkins接口规则：要么没带合法认证信息，要么开了CSRF防护没带crumb令牌，要么参数格式不是Jenkins能识别的application/x-www-form-urlencoded表单格式，请求被服务端直接丢弃。
• URL拼接参数能触发但传不了大体积内容，是因为HTTP协议对URL长度有默认限制（多数服务端配置为2KB~8KB），大段JSON必然触发长度截断，根本不适合传大体积参数。

方案1：表单POST传参（适配100KB以内的请求体） #

提前在目标Jenkins Job的配置页开启参数化构建，添加三个字符串参数：REQUEST_URL（存目标API地址）、REQUEST_BODY（存JSON请求体）、AUTH_INFO（存目标API的鉴权信息），之后用以下格式调用接口：

# 替换为实际的Jenkins地址、任务名、认证信息
JENKINS_HOST="http://jenkins.xxx.com"
JOB_NAME="api-proxy-task"
JENKINS_USER="你的Jenkins用户名"
JENKINS_API_TOKEN="你的Jenkins用户API Token"

# 大段JSON直接存在变量里，避免手动转义出错
TARGET_API_URL="https://target-api.xxx.com/path"
TARGET_AUTH="Bearer xxxxxxx"
TARGET_BODY='{"大段JSON":"内容直接放这里，不用提前转义"}'

curl -X POST "${JENKINS_HOST}/job/${JOB_NAME}/buildWithParameters" \
  -u "${JENKINS_USER}:${JENKINS_API_TOKEN}" \
  --data-urlencode "REQUEST_URL=${TARGET_API_URL}" \
  --data-urlencode "AUTH_INFO=${TARGET_AUTH}" \
  --data-urlencode "REQUEST_BODY=${TARGET_BODY}"

注意：必须调用/buildWithParameters接口而非/build接口，后者不会解析传入的自定义构建参数。Jenkins 2.96及以上版本用API Token认证时，不需要额外申请CSRF crumb令牌，会自动豁免校验。如果curl版本过低不支持--data-urlencode，提前把每个参数值做urlencode编码后，用--data "k1=v1&k2=v2"格式提交即可，效果一致。

方案2：文件上传传参（适配MB级超大请求体） #

如果请求体体积超过100KB，容易触发Jenkins字符串参数的长度限制，直接用文件参数传递：

• 在Job的参数化构建配置中新增文件参数，参数名设置为REQUEST_BODY_FILE
• 把大体积JSON请求体存在本地文件（比如local_request.json），用以下命令调用接口：

curl -X POST "${JENKINS_HOST}/job/${JOB_NAME}/buildWithParameters" \
  -u "${JENKINS_USER}:${JENKINS_API_TOKEN}" \
  --form "file=@./local_request.json;filename=REQUEST_BODY_FILE" \
  --form "REQUEST_URL=${TARGET_API_URL}" \
  --form "AUTH_INFO=${TARGET_AUTH}"

• 在Jenkins Job的构建步骤中，直接读取工作目录下的REQUEST_BODY_FILE文件内容作为请求体，向目标API发起POST请求即可，全程没有参数长度限制。

如果调用后还是没触发任务，在curl命令最后加-v参数打印完整请求响应日志，可快速定位是认证失败、被CSRF拦截、还是参数格式错误。

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