Spring Cloud Feign调用Postman Echo时POJO响应字段未正确填充

• POJO结构与实际接口返回的JSON结构字段不匹配，Jackson反序列化时无法找到对应映射关系，导致字段填充为null
  • 自定义的Args类定义字段为foo、bar，但目标接口返回的args节点下的实际键是foo1、foo2，完全没有匹配关系，因此两个字段都为null
  • 自定义的Headers类中，接口返回的请求头键普遍使用中划线分隔（如x-forwarded-proto、user-agent），而Jackson默认的命名策略无法直接将中划线分隔的键映射为驼峰命名的Java字段，若不做特殊配置，这些字段也会出现填充为null的情况
• Feign接口将查询参数硬编码在请求路径中的写法不规范，虽不直接影响反序列化，但存在路径解析异常的潜在风险

1. 修正Args类的字段定义，与接口返回的键名保持一致

   @Data
   @AllArgsConstructor
   @NoArgsConstructor
   class Args {
       private String foo1;
       private String foo2;
   }
   

   若需要保留原有foo、bar的字段名，可通过Jackson的@JsonProperty注解建立映射关系：

   class Args {
       @JsonProperty("foo1")
       private String foo;
       @JsonProperty("foo2")
       private String bar;
   }
   

2. 解决Headers类的键名映射问题
   有两种可选方案：

   • 逐字段添加@JsonProperty注解，显式声明JSON键与Java字段的对应关系：

     @Data
     @AllArgsConstructor
     @NoArgsConstructor
     class Headers {
         @JsonProperty("x-forwarded-proto")
         private String xForwardedProto;
         @JsonProperty("x-forwarded-port")
         private String xForwardedPort;
         private String host;
         @JsonProperty("x-amzn-trace-id")
         private String xAmznTraceId;
         @JsonProperty("user-agent")
         private String userAgent;
         private String accept;
         @JsonProperty("postman-token")
         private String postmanToken;
         @JsonProperty("accept-encoding")
         private String acceptEncoding;
     }
     

   • 全局配置Jackson的命名策略为中划线转驼峰，在application.properties中添加配置：

     spring.jackson.property-naming-strategy=org.springframework.boot.jackson.JsonComponentModule$KebabCaseStrategy
     

     配置完成后无需逐字段加注解，Jackson会自动将中划线分隔的JSON键，映射为驼峰命名的Java字段。

3. 优化Feign接口的参数写法，避免硬编码拼接查询参数
   使用@RequestParam注解显式声明查询参数，提升可读性与稳定性：

   @FeignClient(name = "postmanEchoClient", url = "https://postman-echo.com")
   public interface PostmanEchoClient {
       @GetMapping("/get")
       PostmanEchoResponse getPostmanEcho(@RequestParam("foo1") String foo1, @RequestParam("foo2") String foo2);
   }
   

   对应的控制器调用逻辑调整为传入固定参数值：

   @GetMapping("/postman/echo")
   public ResponseEntity<?> getPostmanEcho() {
       return ResponseEntity.ok(postmanEchoClient.getPostmanEcho("bar1", "bar2"));
   }
   

完成上述调整后重新调用本地接口，响应中的args节点会正确返回foo1: bar1、foo2: bar2的内容，headers节点的字段也会被正常填充，不会出现null值。

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