使用Python自动创建JIRA工单失败，求排查解决方法

核心问题分析 #

你的代码存在两个关键错误：

1. 重复初始化Jira实例并错误设置URL：第二次初始化时将URL指定为https://jira.example.com/rest/api/2/issue——这是API的具体端点，而Jira类需要传入的是实例基础URL（如https://jira.example.com/），库会自动拼接正确的API路径。
2. 未捕获完整错误响应：当前报错仅抛出HTTPError，但未输出响应体内容，而JIRA API会返回具体失败原因（比如必填字段缺失、项目不存在、权限不足等），这是排查的关键信息。

排查与修复步骤 #

1. 修正Jira实例初始化 #

删除重复的Jira初始化代码，全程使用同一个基础URL的实例。

2. 捕获并打印详细错误信息 #

修改代码，捕获requests.exceptions.HTTPError后打印响应的JSON内容，以此定位具体失败原因：

try:
    jira.issue_create(fields=...)
except requests.exceptions.HTTPError as e:
    print("完整错误响应:", e.response.json())
    raise

3. 验证必填字段完整性 #

不同JIRA项目和工单类型可能存在额外必填字段（如优先级、经办人等），可通过JIRA界面或API查询目标项目下「Task」类型的必填字段要求。

4. 确认权限有效性 #

确保你的个人访问令牌（PAT）拥有创建工单的权限，且对目标项目具备访问权限。

修复后的完整代码 #

from atlassian import Jira
import requests

# 仅初始化一次Jira实例，使用基础URL
jira = Jira(
    url   = "https://jira.example.com/",
    token = "MyPersonalAccessToken"
)

# 验证认证有效性
proj = jira.get_project('PROJECT_KEY')  # 替换为实际项目Key
print(proj.get("id"))

# 尝试创建工单并捕获详细错误
try:
    response = jira.issue_create(
        fields={
            'project': {
                'key': 'PROJECT_KEY'  # 替换为实际项目Key
            },
            'summary': 'Testing JIRA python API',
            'description': 'testing',
            'issuetype': {
                "name": "Task"
            },
            # 若存在必填字段，需补充此处，示例：
            # 'priority': {'name': 'Medium'}
        }
    )
    print("工单创建成功，ID:", response.get('id'))
except requests.exceptions.HTTPError as e:
    print("创建失败，详细错误信息:", e.response.json())
    raise

常见失败原因及解决方式 #

• 字段缺失：响应会提示"errors": {"fieldName": "Field is required"}，补充对应必填字段即可。
• 项目Key错误：提示"project": "Project does not exist"，确认项目Key是否正确。
• 权限不足：提示"errorMessages": ["You do not have permission to create issues in this project"]，检查PAT的权限设置。
• 工单类型不存在：提示"issuetype": "Issue type does not exist"，确认项目中是否存在名为「Task」的工单类型。

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