Spring Boot中如何将Feign Client对象关联到特定响应key？

这个问题我之前也碰到过，核心原因很明确：你期望Feign直接返回List<Providers>，但第三方API实际返回的是一个包含success和data字段的顶层JSON对象，Jackson没法把一个完整的JSON对象直接转换成列表，所以才抛出了MismatchedInputException这个错误。

下面是一步步的解决方法：

1. 先做个响应包装类 #

首先得定义一个和第三方API返回结构完全对齐的包装类，用来接收完整的响应内容：

import java.util.List;

public class ProviderResponse {
    private boolean success;
    private List<Providers> data;

    // 记得生成getter和setter方法，嫌麻烦的话可以用Lombok的@Data注解一键生成
    public boolean isSuccess() {
        return success;
    }

    public void setSuccess(boolean success) {
        this.success = success;
    }

    public List<Providers> getData() {
        return data;
    }

    public void setData(List<Providers> data) {
        this.data = data;
    }
}

2. 调整Feign Client的返回类型 #

把Feign Client接口里的返回值从List<Providers>改成刚创建的ProviderResponse：

@FeignClient(name = "CerberusClient", url = "${service.cerberus.url}")
public interface CerberusClient {
    @RequestMapping(value = "/providers/", method = RequestMethod.GET, produces = "application/json")
    ProviderResponse getAllProviders();
}

3. 修改控制器的逻辑 #

在控制器里，我们需要从ProviderResponse里取出data字段再返回给调用方，还可以顺便做个状态判断：

@RestController
@RequestMapping("/cerberus/")
public class CerberusProvidersImpl {
    @Autowired
    private CerberusClient cerberusClient;

    @RequestMapping(value = "/getAllProviders", method = RequestMethod.GET, produces = "application/json")
    public List<Providers> getAllProviders() {
        ProviderResponse response = cerberusClient.getAllProviders();
        // 这里可以根据success字段做异常处理，比如返回空列表或者抛出业务异常
        if (!response.isSuccess()) {
            throw new RuntimeException("Failed to fetch providers from Cerberus API");
        }
        return response.getData();
    }
}

额外提醒：日期字段的解析问题 #

另外注意你的Providers类里的created_at和modified_at是Date类型，第三方返回的是ISO 8601格式的字符串，可能需要加Jackson注解来确保正确解析：

import com.fasterxml.jackson.annotation.JsonFormat;
import java.util.Date;

public class Providers {
    private Integer id;
    private String name;
    private String site;
    
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSSSSXXX")
    private Date created_at;
    
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSSSSXXX")
    private Date modified_at;

    // 生成getter和setter方法
}

这样调整之后，Feign就能正确解析第三方的响应了，再把里面的data列表返回给你的调用方就没问题啦。

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