Spring Boot集成PayPal Payouts：解析响应获取batch_status失败

问题根源 #

核心问题是实体类结构与JSON响应的层级不匹配：JSON里的batch_status和payout_batch_id嵌套在batch_header对象下，但你的PayOutResponse类直接把这两个字段放在了根层级，导致Jackson无法正确映射字段值。添加@JsonIgnoreProperties(ignoreUnknown=true)只能忽略未知字段，无法跨层级读取数据，所以最终status为null。

解决方案一：修正实体类结构（推荐） #

按照JSON的层级结构创建嵌套实体类，让Jackson可以正确映射每个字段：

1. 定义匹配的实体类 #

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
@NoArgsConstructor
@JsonIgnoreProperties(ignoreUnknown = true) // 忽略未定义的冗余字段
public class PayOutResponse {
    private BatchHeader batch_header; // 对应JSON中的batch_header对象

    // 嵌套类，对应batch_header的结构
    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    @JsonIgnoreProperties(ignoreUnknown = true)
    public static class BatchHeader {
        private String payout_batch_id;
        private String batch_status;
        // 不需要sender_batch_header的话，无需定义该字段
    }
}

2. 解析并读取字段 #

ObjectMapper mapper = new ObjectMapper();
PayOutResponse responseObject = mapper.readValue(response, PayOutResponse.class);
String status = responseObject.getBatch_header().getBatch_status();
String batchId = responseObject.getBatch_header().getPayout_batch_id();

解决方案二：用JsonNode直接解析（无需实体类） #

如果只需要读取batch_status单个字段，不需要完整映射实体类，可以直接用Jackson的JsonNode快速读取：

ObjectMapper mapper = new ObjectMapper();
JsonNode rootNode = mapper.readTree(response);
String status = rootNode.path("batch_header").path("batch_status").asText();
// 如需读取payout_batch_id
String batchId = rootNode.path("batch_header").path("payout_batch_id").asText();

path()方法的优势是：如果字段不存在不会抛出异常，返回MissingNode后调用asText()会返回空字符串，避免空指针问题。

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