Jira中如何将任务正确关联到Epic史诗并显示在仪表板上？

IT人俊轶提问于 2026-02-04 11:17:27 阅读 64

工具

我在用Jira管理前端项目时遇到了问题，创建了几个子任务并尝试关联到Epic史诗，但仪表板始终显示关联数为0。已经确认在任务描述里填了”Epic链接: ABC-123″，也通过API尝试过设置，但就是不生效…

我试过这样写API请求：


const issueData = {
  fields: {
    project: { key: 'ABC' },
    summary: '登录页优化',
    epic: 'EPIC-456' // 这里是不是写法有问题？
  }
};
fetch('https://jira.example.com/rest/api/2/issue', {
  method: 'POST',
  body: JSON.stringify(issueData)
});

但返回的错误是”Field ‘epic’ cannot be set”。其他同事用同样的流程没问题，我该检查哪里呢？

Epic史诗

我来解答赞 10 收藏

反馈

2 条解答

芳宁（打工版） Lv1

Jira里关联Epic的字段不是叫epic，而是customfield_10004这种ID。官方文档里说这个字段要通过customfield_issuelinks类型来操作。

你看到的"Epic链接: ABC-123"这种写法是Jira自动解析的文本格式，但API里不能这么写。用REST API的话要这样调：

先查一下项目的Epic字段ID：
GET /rest/api/2/issue/createmeta?projectKeys=ABC&expand=projects.issuetypes.fields

找到返回数据里类型是customfield_issuelinks的字段，通常会是customfield_10004。然后用这个ID来发请求：

const issueData = {
fields: {
project: { key: 'ABC' },
summary: '登录页优化',
customfield_10004: 'EPIC-456'
}
};

发完创建任务的请求后，建议用GET接口查一下返回数据，确认字段确实写进去了。有时候权限问题或者字段只读状态会导致写入失败但不报错。

仪表板显示关联数需要检查两个地方：一是Epic本身的统计范围，二是看板的筛选条件是否漏掉了某些状态的任务。

2026-02-06 11:06

Tr° 欣亿 Lv1

Jira里关联Epic不是靠字段直接填的，你那个API写法确实有问题。正确做法是：

1. 先确认你的Jira项目类型是"Scrum"或"Kanban"，不是普通项目模板
2. 需要安装并启用"Advanced Roadmaps"插件
3. 在任务创建界面右上角有个"EPIC"下拉框选择关联项，不是填描述
4. API正确写法应该是：

const issueData = {

  fields: {

    project: { key: 'ABC' },

    summary: '登录页优化',

    issuetype: { name: 'Story' },

    'com.atlassian.jira.plugin.system.customfield:type=epiclink': 'EPIC-456'

  }

};

这个字段名称要写完整自定义字段ID。建议你先手动关联一个任务看看数据库记录，再用API照着格式写。仪表板可能还要检查是否添加了"Epic面板"组件。

2026-02-04 12:05