You need to enable JavaScript to run this app. Spring Java调用Jira API解析issue JSON列表返回空数组
优惠活动
大模型
产品
解决方案
定价
更多

Spring Java调用Jira API解析issue JSON列表返回空数组

问题根因

Spring RestTemplate默认使用Jackson做JSON序列化与反序列化,映射逻辑为严格匹配Java类字段名与JSON键名,不会根据类名自动猜测对应关系。
获取的issue列表为空的核心原因:

  • Jira接口返回的JSON中,存储issue数组的顶层键为issues
  • 自定义ValueList类中用于接收该数组的字段名为valueList

二者名称完全不匹配,Jackson无法将JSON中的数组内容赋值到Java对象上,最终取到的列表自然为空。

修正方案

两种等价修正方式任选其一即可:

方案1:对齐字段名

给ValueList补充未知字段忽略注解(避免JSON中expand、startAt、total这类未定义字段触发反序列化异常),将字段名调整为与JSON键完全一致的issues:

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import java.util.List;

@JsonIgnoreProperties(ignoreUnknown = true)
public class ValueList {
    private List<Value> issues;

    public List<Value> getIssues() {
        return issues;
    }

    public void setIssues(List<Value> issues) {
        this.issues = issues;
    }
}

对应调整主类中的取值逻辑,将原代码response.getValueList()替换为response.getIssues()即可。

方案2:通过注解指定映射关系

如果希望保留原有ValueList的字段名和取值逻辑,可在字段上添加@JsonProperty注解,手动指定该Java字段对应的JSON键:

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;

@JsonIgnoreProperties(ignoreUnknown = true)
public class ValueList {
    @JsonProperty("issues")
    private List<Value> valueList;

    // 原有getter、setter逻辑完全保留
    public List<Value> getValueList() {
        return valueList;
    }

    public void setValueList(List<Value> valueList) {
        this.valueList = valueList;
    }
}

该方案下主类原有取值代码无需改动,即可获取正确的issue列表。

其他注意事项
  • 原有Value类无需修改:类上已配置忽略未知字段注解,id、key字段与Jira返回的issue对象键名完全匹配,可正常完成单条issue的字段映射
  • 后续若需拉取看板全量issue(示例中总条数为250),可在ValueList中补充startAt、maxResults、total字段,配合Jira接口的分页参数逐页拉取,避免单次请求受返回条数上限限制
  • 调试阶段可直接打印RestTemplate请求返回的原始JSON字符串,逐行核对字段名与Java类字段的匹配关系,减少拼写错误、大小写不匹配这类低级问题

内容的提问来源于stack exchange,提问作者Carnage6194

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 15:45:01