Jenkins执行Xray结果导入任务报错project is required如何解决？

开始从cucumber.json导入执行结果：文件路径：/var/jenkins_home/workspace/XRAY_TEST/target/cucumber.json
开始从cucumber.json导入结果
错误：步骤‘Xray: Results Import Task’执行失败：无法确认上传结果，上传失败！状态码：400 响应内容：{"error":"Error assembling issue data: project is required"}
构建结束：FAILURE

该错误是Xray服务端接收导入请求时，没有从请求参数/结果文件中读取到必填的Jira项目标识（项目Key或项目ID），无法将测试结果关联到对应Jira项目，因此返回400错误拒绝请求。

• 检查Jenkins任务内Xray导入步骤的配置：确认「Project Key」字段是否为空，或者填写内容错误（比如填了项目全称而非缩写Key、大小写不匹配）
• 检查参数化配置：如果是通过构建变量传递项目Key（比如$XRAY_PROJECT_KEY），确认变量名拼写正确，构建运行时该变量有被正常赋值，不存在空值情况
• 检查cucumber.json内容：确认测试用例关联的标签中没有错误的项目配置，也没有覆盖全局项目参数的异常标签
• 检查Jenkins全局Xray配置：进入系统管理的Xray配置页，确认默认项目配置没有被清空，服务账号的Jira权限正常

• 若Xray导入步骤的Project Key为空：直接填入对应Jira项目的正确Key（Jira项目地址后缀的大写缩写，比如项目地址为https://jira.example.com/projects/TEST，Key即为TEST）
• 若变量传递异常：可以在构建步骤中增加一行echo $你的项目变量名打印变量值，排查变量为空的原因，修正变量拼写或参数赋值规则
• 若需要从结果文件指定项目：在cucumber.json对应feature的tags中增加@PROJECT_KEY=XXX标签，Xray会优先读取该标签内的项目配置
• 修复后可以先通过curl命令手动验证配置有效性：

curl -H "Content-Type: application/json" -X POST -u "Jira账号:Jira密码" "https://你的Jira域名/rest/raven/1.0/import/execution/cucumber?projectKey=你的项目KEY" -d @本地cucumber.json路径

命令返回成功即代表配置无误，再重新执行Jenkins任务即可。

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