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
相关产品推荐
相关产品推荐

