使用Azure DevOps REST API排队构建时参数传递失败求助

我之前也踩过这个坑，Azure DevOps的API文档确实对parameters字段的格式描述太模糊了。核心问题在于API要求parameters的值必须是JSON字符串，而非原始JSON对象，同时要保证字符串里的参数名称和你管道定义中的参数完全匹配（包括大小写）。

正确的请求体示例 #

{
  "parameters": "{\"appId\": \"bab\", \"platform\": \"android\", \"isDemo\": true}",
  "definition": { "id": 1 },
  "sourceBranch": "refs/heads/feature/my-pipeline",
  "sourceVersion": "d265f01aeb4e677a25725f44f20ceb3ff1d7d767"
}

为什么之前的方式会失败？ #

• 直接传JSON对象：API的parameters字段不接受原始JSON结构，它只认序列化后的字符串，所以这种方式下参数会被完全忽略，自然触发必填项验证错误。
• 字符串化格式可能存在转义问题：如果你的字符串化过程中没有正确转义双引号，或者生成的字符串格式不规范，API无法解析出有效参数。比如必须确保内部的每个双引号都用\"转义，且整个参数是一个完整的字符串。

实用调试技巧 #

要是还是拿不准格式，你可以先在Azure DevOps UI里手动触发一次构建，然后打开浏览器开发者工具（F12），查看POST /_apis/build/builds请求的请求体，里面会有官方生成的正确parameters格式，直接照搬就行。

额外注意事项 #

• 管道定义里的参数名称和你传递的必须完全一致（比如YAML里定义的是appId，就不能写成AppId或者appid）。
• 如果参数包含特殊字符，要确保字符串化时做了正确转义。

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