Jira自定义应用保存筛选视图后无法保存/获取选中列求助

问题概述 #

我是Jira新手，基于Atlassian Connect Express开发Jira自定义应用，使用Jira REST API v3和Atlassian Design System组件。应用内包含两个筛选下拉框：列筛选和Jira问题状态筛选。保存筛选视图时，执行流程为：

1. 调用 POST /rest/api/3/filter 创建筛选器
2. 调用 GET /rest/api/3/filter/search 获取已创建的筛选器

目前仅状态筛选配置能成功保存，列筛选的配置完全未被保存。

已尝试的操作 #

• 调用 PUT /rest/api/3/filter/{id}/columns 传入选中列设置筛选器列，无效果
• 调用 GET /rest/api/3/filter/{id}/columns 获取列配置，返回结果中无已设置的列

环境信息 #

• 开发框架：Atlassian Connect Express
• API版本：Jira REST API v3
• UI组件：Atlassian Design System

排查方向与解决建议 #

1. 确认API权限范围 #

检查应用的atlassian-connect.json文件，确保声明了足够的权限范围：

• 读写工作项：read:jira-work、write:jira-work
• 管理配置（如需）：manage:jira-configuration
  权限不足会导致列配置接口静默失败。

2. 验证PUT请求参数格式 #

Jira API要求列参数为系统认可的字段键数组（不能用自定义显示名称），示例正确请求体：

{
  "columns": ["summary", "status", "assignee", "created"]
}

检查代码中传入的列参数是否使用了正确的字段键，避免拼写错误或使用显示名称。

3. 检查筛选器权限归属 #

创建筛选器时，确保应用拥有该筛选器的修改权限：

• 创建接口返回的筛选器ID需准确传递给列配置接口
• 可在创建筛选器时显式设置owner为当前操作用户，避免因权限归属问题导致修改失败

4. 捕获API错误响应 #

在代码中添加错误日志，打印PUT /rest/api/3/filter/{id}/columns的响应状态码与响应体，排查是否存在：

• 403：权限不足
• 400：参数格式错误
• 404：筛选器ID无效

5. 代码逻辑检查 #

克隆项目后重点排查：

• 创建筛选器后，获取返回ID的逻辑是否正确
• 列配置接口的请求头是否携带了有效的JWT授权令牌
• 请求参数是否完整、格式是否符合API文档要求

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