Jenkins多分支项目调用/buildWithParameters POST请求失败：提示未参数化

我之前也踩过这个坑，多分支项目的参数处理逻辑和普通流水线项目确实不一样，给你梳理下具体的解决步骤：

核心原因 #

多分支项目的每个分支对应的作业是动态生成的——Jenkins需要先扫描到目标分支、解析该分支下的Jenkinsfile，才能识别到里面定义的参数。直接调用多分支项目根节点的API是无效的，必须针对具体分支的子作业发起请求。

具体解决方案 #

1. 先让Jenkins识别到目标分支的子作业 #

手动触发多分支项目的立即扫描多分支流水线操作，等扫描完成后，去多分支项目页面确认目标分支对应的子作业已经生成（比如你要运行main分支，就能看到列表里有main的作业条目）。

2. 调用正确的API端点 #

别再请求多分支项目根路径的/buildWithParameters了，要针对具体分支的子作业来构造URL，格式如下：

http://<你的Jenkins地址>/job/<多分支项目名称>/job/<目标分支名称>/buildWithParameters

举个实际例子：如果你的多分支项目叫MyAppPipeline，目标分支是dev，完整请求URL大概是：

http://jenkins.mycompany.com/job/MyAppPipeline/job/dev/buildWithParameters?P_A=my_custom_a&P_B=dev@mycompany.com

用curl调用的话（记得替换成你的用户名和API Token）：

curl -X POST "http://jenkins.mycompany.com/job/MyAppPipeline/job/dev/buildWithParameters?P_A=my_custom_a&P_B=dev@mycompany.com" --user "your-username:your-api-token"

3. 若仍不生效，手动触发一次分支构建 #

如果扫描完分支后调用API还是报错，那就手动触发该分支的一次构建（哪怕是空跑一遍）。这一步会让Jenkins重新解析Jenkinsfile里的参数定义，更新分支作业的参数配置，之后再调用API就能正常识别参数了。

4. 检查权限设置 #

确保你用来调用API的用户，拥有该分支子作业的构建权限以及触发远程构建的权限（如果Jenkins开启了安全管控的话）。可以去分支作业的「配置」->「权限」页面确认设置。

额外注意点 #

• 参数名要和Jenkinsfile里定义的name完全一致，大小写敏感！比如你定义的是P_A，就不能写成p_a。
• 如果参数值里有特殊字符（比如&、空格），记得要URL编码后再传递。

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