使用Python创建Jira问题报错：Epic Link字段为空

我正尝试用Python的jira==3.5.2模块实现最基础的Jira任务创建功能。

我的代码 #

constants.py #

from jira import JIRA

JIRA_TOKEN = "TOKEN"

ji = JIRA('https://ourdomain.atlassian.net', basic_auth=('myname@companyname.com', JIRA_TOKEN))

main.py #

from constants import *
from pprint import pprint

def jira_create_issue(summary: str, description: str):

    issue_dict = {
        'project': {'key': 'QD'},
        'summary': 'TEST JIRA PYTHON',
        'description': 'test',
        'issuetype': {'name': 'Bug'},
    }

    new_issue = ji.create_issue(fields=issue_dict)

def main():
    jira_create_issue("test rest", "test rest1")

if __name__ == "__main__":
    main()

遇到的错误 #

1. 执行代码时收到HTTP 400错误：

response text = {"errorMessages":["Epic Link Field is Empty !"],"errors":{}}

2. 尝试在issue_dict中添加Epic Link字段（试过epiclink, EpicLink, Epic Link, epic link, epic等多种形式），又出现错误：

response text = {"errorMessages":[],"errors":{"Epic Link":"Field 'Epic Link' cannot be set. It is not on the appropriate screen, or unknown."}}

疑问 #

我哪里操作有误？在Jira控制台手动创建任务时，确实存在带下拉选项的Epic Link字段，但该字段的正确键名是什么？文档中并未提及。

1. 确定Epic Link字段的实际键名 #

Jira的Epic Link属于自定义字段，显示名称和实际API键名不一致，需要通过API获取正确字段信息：
添加以下代码到你的项目中执行：

# 列出所有包含epic关键词的字段
fields = ji.fields()
for field in fields:
    if 'epic' in field['name'].lower():
        print(f"字段名称: {field['name']}, 字段键: {field['key']}, 字段ID: {field['id']}")

执行后会得到类似customfield_10014这样的字段键（不同Jira实例ID不同），这就是你需要用的键名。

2. 确保字段在Bug创建屏幕上可见 #

出现“Field cannot be set”错误，说明Epic Link字段未添加到Bug类型的创建屏幕中：

• 登录Jira后台，进入问题 > 字段 > 屏幕
• 找到Bug类型使用的创建屏幕，将Epic Link字段添加到该屏幕的字段列表中

3. 修正创建任务的代码 #

用获取到的字段键替换，同时填入要关联的Epic的键（比如QD-123）：

issue_dict = {
    'project': {'key': 'QD'},
    'summary': 'TEST JIRA PYTHON',
    'description': 'test',
    'issuetype': {'name': 'Bug'},
    'customfield_10014': 'QD-123'  # 替换为你的实际字段键和Epic键
}

额外注意 #

• Epic Link字段的值必须是Epic的键（如QD-123），不能用Epic名称
• 确保你的账号拥有创建Bug并关联Epic的权限

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