Jira Cloud REST API v3返回空issuelinks数组问题求助

以下是排查和解决的关键点：

1. 确认关联问题所在项目的访问权限 #

即使你有当前项目的Browse Projects和Link Issues权限，若关联问题属于另一个项目，且你没有该项目的Browse Projects权限，Jira API会隐藏这条链接，返回空的issuelinks数组。

• 验证方式：手动访问Jira界面中关联问题的详情页，确认能正常打开；调用/rest/api/3/mypermissions?projectKey=<关联问题项目key>&permissions=BROWSE_PROJECTS，检查返回是否为true。

2. 调整API请求的参数配置 #

单问题接口 #

尝试添加expand参数强制展开链接内容：

/rest/api/3/issue/<issue key>?fields=issuelinks&expand=issuelinks

搜索接口 #

确保fields参数正确包含issuelinks，若同时指定其他字段，用逗号分隔：

/rest/api/3/search?jql=project=XXX&fields=issuelinks,summary,status

避免使用fields=-*all这类排除所有字段后再包含的写法，可能导致字段加载异常。

3. 检查问题链接的实际配置 #

• 在Jira界面中打开目标问题，确认关联链接不是已删除的自定义链接类型（这类链接在界面可能仍显示，但API不会返回）；
• 确认链接是双向关联（比如blocked和blocked by是一对双向链接），若仅创建了单向关联，API可能无法正确识别。

4. 验证API调用的身份信息 #

确保调用API时使用的是正确的账号凭证（邮箱+API令牌），而非其他无权限的账号。可以通过调用/rest/api/3/myself接口，确认当前登录的用户是你预期的账号。

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