Spring Boot微服务使用RestTemplate通信遇反序列化异常求助

报错堆栈里的关键信息已经明确指向问题：

Cannot deserialize instance of com.java.connect.entity.Product out of START_ARRAY token
该错误的含义是：你请求的 http://localhost:8081/products 接口实际返回的是Product对象组成的JSON数组，但你代码中强行指定要将返回内容反序列化为单个Product对象，类型不匹配直接触发解析异常。

场景1：业务逻辑需要获取单个Product对象 #

• 先确认远端8081服务的接口规则：要么将请求地址替换为明确返回单个商品的接口路径（例如http://localhost:8081/products/1这类按ID查询单商品的接口），要么修正8081端/products接口的返回逻辑，确保它返回单个Product对象而非数组。
• 修正后的可运行代码：

@GetMapping("/name")
public Product name(){
    RestTemplate restTemplate = new RestTemplate();
    // 替换为实际返回单商品的接口地址
    Product product = restTemplate.getForObject("http://localhost:8081/products/1", Product.class);
    return product;
}

注意：确保本地Product实体类和远端返回的JSON结构完全匹配：字段名一致、类型对应，且实体类具备无参构造方法、getter/setter方法，否则会触发其他反序列化异常。

场景2：业务逻辑需要获取接口返回的全部Product列表 #

受Java泛型擦除机制限制，不能直接用List.class指定返回类型，需要借助Spring提供的ParameterizedTypeReference保留泛型信息，正确实现代码：

import org.springframework.core.ParameterizedTypeReference;
import org.springframework.http.HttpMethod;
import java.util.List;

@GetMapping("/name")
public List<Product> name(){
    RestTemplate restTemplate = new RestTemplate();
    // 显式指定反序列化目标类型为List<Product>
    List<Product> productList = restTemplate.exchange(
            "http://localhost:8081/products",
            HttpMethod.GET,
            null,
            new ParameterizedTypeReference<List<Product>>() {}
    ).getBody();
    return productList;
}

• 无需在每个接口方法内手动new RestTemplate：RestTemplate是线程安全的对象，可在配置类中注册为单例Bean直接注入使用，减少不必要的对象创建开销。
• 调试优先验证接口返回结构：可直接通过浏览器、Postman等工具访问目标接口，先确认实际返回的JSON结构，再编写对应的反序列化逻辑，避免盲目猜测返回类型。
• 字段映射适配：如果远端返回的JSON字段名和本地Product实体类字段名不一致，可在实体类字段上加@JsonProperty("远端字段名")注解完成映射，解决不匹配问题。

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