Python无法更新Jira Cloud可编辑文本自定义字段问题

针对你遇到的Python脚本能添加评论但无法更新customfield_10121字段的问题，按以下步骤排查解决：

1. 确认字段是否关联到编辑屏幕 #

Jira的自定义字段必须关联到对应工单类型的编辑屏幕，否则即使权限允许，API更新也不会生效且无报错：

• 进入Jira管理后台 → 自定义字段 → 找到customfield_10121 → 点击「查看配置」
• 检查该字段的「屏幕配置」，确保当前工单所属的项目、工单类型对应的编辑屏幕已包含此字段

2. 检查字段上下文限制 #

如果字段设置了上下文（比如仅允许特定项目/工单类型使用），而目标工单不在范围内，更新操作会静默失败：

• 在自定义字段的配置页面，查看「上下文」设置，确认目标工单符合上下文规则

3. 开启调试日志验证API请求 #

在创建Jira客户端对象时开启调试日志，查看实际发送的API请求和响应，确认参数是否正确：

def jira_obj(self):
    from jira import JIRA
    options = {
        'server': '你的Jira Cloud地址',
        'logging': 'DEBUG'
    }
    return JIRA(options=options, basic_auth=('你的账号', 'API令牌'))

运行脚本后，查看日志中发送的PUT请求内容，确认customfield_10121的参数格式是否正确。

4. 用REST API直接测试排除库的问题 #

绕过Python库，用curl直接调用Jira API测试：

curl -X PUT \
  https://your-domain.atlassian.net/rest/api/3/issue/ISSUE-123 \
  -H "Authorization: Basic 你的base64编码账号令牌" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"customfield_10121": "OK"}}'

如果此请求能成功更新字段，说明问题出在Python脚本的调用逻辑；如果仍失败，返回的响应会包含具体错误信息（比如字段不可用、无权限等）。

5. 适配字段的数据格式要求 #

部分文本类型的自定义字段（比如多行文本）可能需要特定的参数格式，尝试修改更新代码：

update_payload = {
    'fields': {
        custom_field_id: {'value': 'OK'}
    }
}
self.jira.update_issue(issue_dict['jira_id'], fields=update_payload['fields'])

代码优化建议 #

在更新操作后添加日志检查，即使无报错也能确认操作状态：

response = self.jira.update_issue(issue_dict['jira_id'], fields=update_payload['fields'])
logging.info(f"更新工单{issue_dict['jira_id']}字段响应: {response}")

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