如何使用Python移除Jira Issue的标签？

你遇到的问题核心是：Jira Python库中标签的移除语法和组件不同——组件是带属性的对象，而标签是纯字符串数组，两者的API操作规范不一样。

正确的标签移除方法 #

有两种可行的实现方式：

方式1：直接修改labels列表后提交

直接过滤掉不需要的标签，再通过fields参数提交更新：

# 移除指定旧标签
issue.fields.labels = [label for label in issue.fields.labels if label != "OLDLABEL"]
# 添加新标签（如果需要）
issue.fields.labels.append("NEWLABEL")
# 提交更新
issue.update(fields={"labels": issue.fields.labels})

方式2：使用update参数的正确语法

Jira API对标签的remove操作不需要嵌套name字段，直接传入标签字符串即可：

# 同时完成添加和移除操作
issue.update(update={
    "labels": [
        {"add": "NEWLABEL"},
        {"remove": "OLDLABEL"}
    ]
})
# 注意：这种方式不需要再单独调用update(fields=...)，update参数已直接提交修改

为什么你之前的写法无效？ #

组件是包含name属性的对象，所以移除时需要通过{"remove": {"name": "组件名"}}指定目标；但标签是字符串数组，API接受直接传入要移除的字符串，不需要嵌套结构，因此你之前的{"remove": {"name": "MYOLDLABEL"}}不符合标签的API规范。

修改你的脚本 #

把脚本中错误的移除代码替换为上述正确方式，同时修正JQL语法错误和缺失的初始化代码：

#!/usr/bin/env python3

import sys
import os  # 补充缺失的os模块导入

# https://pypi.org/project/jira/
from jira import JIRA

JIRA_API_TOKEN_ENV_NAME = 'JIRA_API_TOKEN'
JIRA_FQDN = 'https://jira.example.com'
# 修正JQL语法：补全括号
JIRA_JQL = 'labels in (OLDLABEL) and labels not in (NEWLABEL)'

def main():
    jira_api_token = os.environ[JIRA_API_TOKEN_ENV_NAME]
    # 补充JIRA客户端初始化
    jira = JIRA(server=JIRA_FQDN, token_auth=jira_api_token)
    issues = jira.search_issues(JIRA_JQL)
    issue_num = 1
    for issue in issues:
        print(f'=== {issue_num} - {issue.key} ===')
        print(f'project { issue.fields.project.key}')
        print(f'state.name { issue.fields.status.name}')
        was_closed = False
        if issue.fields.status.name == 'Closed':
            was_closed = True

        print(f'labels before { issue.fields.labels }')

        if was_closed:
            print('Was closed, reopening')
            jira.transition_issue(issue, '3')   # transition id 3 - name Reopen Issue

        # 方式1：修改列表后提交
        issue.fields.labels.append('NEWLABEL')
        issue.fields.labels = [lbl for lbl in issue.fields.labels if lbl != 'OLDLABEL']
        issue.update(fields={"labels": issue.fields.labels})

        # 或者用方式2替代上面三行：
        # issue.update(update={"labels": [{"add": "NEWLABEL"}, {"remove": "OLDLABEL"}]})

        if was_closed:
            print('Was closed, reclosing')
            jira.transition_issue(issue, '2')   # transition id 2 - name Close Issue

        issue_num = issue_num + 1
        print('')

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