调用JIRA REST API更新issue标签失败 返回200状态码

JIRA更新工单接口有个特殊逻辑：针对无操作权限、未配置在编辑屏幕、格式不识别的字段，不会抛出错误响应，会静默丢弃对应更新内容，返回200状态码和当前工单的全量数据，这是该问题的核心诱因，按以下优先级排查即可：

• 检查字段屏幕配置
  打开APP-1工单的Web端编辑页，查看是否存在标签输入框。如果找不到标签输入项，说明系统默认的labels字段未被添加到当前项目、对应工单类型的编辑屏幕中，这种场景下接口会直接忽略所有标签相关的更新参数，不会返回任何报错。联系JIRA管理员将labels字段加入对应编辑屏幕后，请求即可正常生效。
• 更换请求结构规避版本兼容问题
  部分JIRA Server/Data Center版本对update块下的标签add操作存在兼容bug，可改用fields块全量传参的方式更新标签。注意该方式为全量覆盖传参，必须携带工单上已存在的全部历史标签，否则会清空原有标签，示例请求如下：

curl --location --request PUT 'https://jiraserverurl/rest/api/2/issue/APP-1' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer XXXX' \
  --data-raw '{
     "fields": {
       "labels": [
          "existing_label_1",
          "existing_label_2",
          "newlabel"
       ]
     }
   }'

• 校验标签规则与账号权限
  • 检查标签规则限制：部分JIRA实例配置了标签命名规范，禁止标签包含空格、特殊字符，或限制普通用户新建标签，仅允许选择标签库中已存在的标签。如果是新建标签权限限制，联系管理员提前在标签库创建newlabel后再发起请求即可。
  • 确认账号操作权限：在Web端手动打开APP-1工单，尝试手动添加目标标签，确认当前鉴权账号拥有工单编辑权限、标签操作权限，排除第三方插件拦截更新请求的情况。

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