Jira API 创建 Issue 时如何指定自定义字段?

之芳~ 阅读 13

我用 Jira 的 REST API 创建 Issue,普通字段比如 summary、issuetype 都能正常传,但一加自定义字段就报错。官方文档说要用 customfield_xxx 的格式,但我试了还是不行。

比如我的自定义字段 ID 是 customfield_10056,类型是单选列表,我这样传:

{
  "fields": {
    "project": { "key": "PROJ" },
    "summary": "测试任务",
    "issuetype": { "name": "Task" },
    "customfield_10056": { "value": "选项A" }
  }
}

结果返回 400 错误,说“字段值无效”。是不是格式不对?还是得用 ID 而不是 value?

我来解答 赞 1 收藏
二维码
手机扫码查看
1 条解答
宇杰 Dev
单选列表的格式本身没问题,大概率是选项值不匹配。Jira 对选项值是精确匹配的,大小写、空格全算,你确认下那个选项在 Jira 里到底叫啥。

实在不行就用 id 传,先调个接口查下这个字段的可选值:

GET /rest/api/2/field/customfield_10056/option


然后改成这样传:

{
"fields": {
"project": { "key": "PROJ" },
"summary": "测试任务",
"issuetype": { "name": "Task" },
"customfield_10056": { "id": "选项的ID" }
}
}


还有个坑,确认这个自定义字段已经加到项目对应的 Field Configuration 里了,不然 API 直接报无效。
点赞 2
2026-03-01 20:00