使用@FeignClient时如何解决InvalidTypeIdException异常？

错误根源 #

这个InvalidTypeIdException是因为Core服务返回的JSON包含了Jackson的类型标识字段（通常是@class），值为com.example.core.domain.Order，但Notification服务的类路径中不存在这个类。Feign默认使用Jackson反序列化时，会尝试根据该类型标识查找对应类，找不到就抛出异常。

以下是无需在Notification服务中重复创建Order类的解决方案：

方案1：修改Core服务的序列化逻辑（推荐） #

最根本的解决方式是让Core服务返回标准的OrderDTO结构，避免携带不属于公共库的类型信息：

• 直接返回OrderDTO：在Core服务的接口中，将Order对象转换为common-library中的OrderDTO再返回，这样序列化后的JSON不会包含com.example.core.domain.Order的类型标识：

  @GetMapping("/api/v1/order/get/{id}")
  public OrderDTO getOrderById(@PathVariable String id) {
      Order order = orderRepository.findById(id).orElseThrow(() -> new RuntimeException("Order not found"));
      // 手动转换或用MapStruct、ModelMapper等工具实现对象转换
      return new OrderDTO(order.getId(), order.getAmount(), order.getStatus());
  }
  

• 移除类型序列化配置：如果Core服务的Order类使用了@JsonTypeInfo注解（用于多态序列化），可以直接移除该注解；或者在Core的Jackson配置中全局禁用默认类型序列化：

  @Configuration
  public class JacksonConfig {
      @Bean
      public ObjectMapper objectMapper() {
          ObjectMapper mapper = new ObjectMapper();
          mapper.disableDefaultTyping();
          return mapper;
      }
  }
  

方案2：在Notification服务中配置Jackson类型映射 #

告诉Jackson，当遇到com.example.core.domain.Order的类型标识时，直接用OrderDTO进行反序列化：

• 全局配置类型映射：在Notification服务的Jackson配置类中注册类型映射：

  @Configuration
  public class JacksonConfig {
      @Bean
      public ObjectMapper objectMapper() {
          ObjectMapper mapper = new ObjectMapper();
          // 将Core服务的Order类标识映射到本地的OrderDTO
          mapper.registerSubtypes(new NamedType(OrderDTO.class, "com.example.core.domain.Order"));
          return mapper;
      }
  }
  

• 局部注解配置：给OrderDTO添加@JsonTypeInfo注解，指定默认实现类：

  @JsonTypeInfo(
      use = JsonTypeInfo.Id.CLASS,
      include = JsonTypeInfo.As.PROPERTY,
      property = "@class",
      defaultImpl = OrderDTO.class
  )
  public class OrderDTO {
      // 字段、构造方法、getter/setter
  }
  

  这样Jackson找不到对应类型时，会自动使用defaultImpl指定的OrderDTO反序列化。

方案3：自定义Feign解码器修改类型标识 #

通过自定义Feign解码器，在反序列化前替换JSON中的类型标识字段：

@Configuration
public class FeignConfig {
    @Bean
    public Decoder feignDecoder() {
        ObjectMapper objectMapper = new ObjectMapper();
        JacksonDecoder defaultDecoder = new JacksonDecoder(objectMapper);

        return (response, type) -> {
            // 读取响应体JSON字符串
            String jsonBody = new String(response.body().asInputStream().readAllBytes(), StandardCharsets.UTF_8);
            // 替换类型标识为OrderDTO的全类名
            String modifiedJson = jsonBody.replace(
                "\"@class\":\"com.example.core.domain.Order\"",
                "\"@class\":\"com.example.common.dto.OrderDTO\""
            );
            // 构造修改后的响应对象
            Response modifiedResponse = response.toBuilder()
                .body(modifiedJson.getBytes(StandardCharsets.UTF_8))
                .build();
            // 交给默认解码器处理
            return defaultDecoder.decode(modifiedResponse, type);
        };
    }
}

注意：如果使用JDK11+，readAllBytes()可以直接用；否则需要引入Apache Commons IO等工具类读取流。

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