如何Mock RestTemplate并测试JSON至InboundMerchants实例的序列化正确性？

首先明确一点：RestTemplate默认使用Jackson（com.fasterxml.jackson）来处理JSON的序列化与反序列化，它会自动注册MappingJackson2HttpMessageConverter作为JSON转换器，所以你测试序列化逻辑时，直接针对Jackson的反序列化行为验证就可以了。

下面分两种场景，给你讲清楚怎么验证所有值都正确映射到InboundMerchants实例中：

一、单独测试反序列化逻辑（最直接，无需HTTP请求） #

这种方式跳过RestTemplate的HTTP调用环节，直接验证JSON到Java对象的映射是否正确，适合快速定位字段匹配、类型兼容这类问题。

1. 准备覆盖全面的测试JSON
   你需要编写一段包含InboundMerchants所有字段的JSON，包括必填项、可选项、嵌套对象（如果有）、集合等。比如假设你的InboundMerchants包含merchants列表和totalCount字段，测试JSON可以这样写：

   {
     "merchants": [
       {
         "id": 123,
         "name": "Test Shop",
         "contact": "test@example.com"
       }
     ],
     "totalCount": 1
   }
   

2. 用Jackson的ObjectMapper直接测试
   因为RestTemplate默认用的就是这个类，所以直接用它来测试反序列化，代码示例：

   // 初始化和RestTemplate默认配置一致的ObjectMapper
   ObjectMapper objectMapper = new ObjectMapper();
   // 你的测试JSON字符串
   String testJson = "{\"merchants\":[{\"id\":123,\"name\":\"Test Shop\",\"contact\":\"test@example.com\"}],\"totalCount\":1}";
   
   try {
       // 反序列化为InboundMerchants对象
       InboundMerchants result = objectMapper.readValue(testJson, InboundMerchants.class);
   
       // 逐一断言每个字段的值是否正确
       assertNotNull(result, "反序列化后的对象不能为null");
       assertEquals(1, result.getTotalCount(), "totalCount字段映射错误");
       assertEquals(1, result.getMerchants().size(), "merchants集合长度不对");
       assertEquals(123, result.getMerchants().get(0).getId(), "商户id映射错误");
       assertEquals("Test Shop", result.getMerchants().get(0).getName(), "商户名称映射错误");
       assertEquals("test@example.com", result.getMerchants().get(0).getContact(), "商户联系方式映射错误");
   
       // 额外测试可选字段：比如去掉JSON里的contact字段，验证对象里该属性是否为null/默认值
   } catch (JsonProcessingException e) {
       // 捕获到异常说明映射有问题，比如字段名不匹配、类型不兼容
       fail("反序列化失败：" + e.getMessage());
   }
   

二、结合RestTemplate测试完整流程（模拟HTTP请求） #

如果你想测试整个调用链路（包括请求头、HTTP方法、响应处理+反序列化），可以用Spring提供的MockRestServiceServer来模拟接口返回，不用依赖真实服务：

// 初始化RestTemplate和模拟服务器
RestTemplate restTemplate = new RestTemplate();
MockRestServiceServer mockServer = MockRestServiceServer.createServer(restTemplate);

// 模拟接口返回的JSON数据
String mockResponse = "{\"merchants\":[{\"id\":456,\"name\":\"Mock Merchant\"}],\"totalCount\":1}";

// 设置预期的请求规则和响应
mockServer.expect(requestTo("http://your-target-url/merchants"))
        .andExpect(method(HttpMethod.GET))
        .andExpect(header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE))
        .andRespond(withSuccess(mockResponse, MediaType.APPLICATION_JSON));

// 执行你原本的RestTemplate调用逻辑
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
HttpEntity<String> request = new HttpEntity<>("", headers);
ResponseEntity<InboundMerchants> result = restTemplate.exchange(
        "http://your-target-url/merchants", HttpMethod.GET, request, InboundMerchants.class);

// 验证反序列化后的对象字段是否正确
InboundMerchants merchants = result.getBody();
assertNotNull(merchants);
assertEquals(1, merchants.getTotalCount());
assertEquals("Mock Merchant", merchants.getMerchants().get(0).getName());

// 验证模拟服务器的预期请求是否都被触发
mockServer.verify();

几个关键注意点 #

• 如果你在InboundMerchants或其内部类用了Jackson注解（比如@JsonProperty指定字段名、@JsonIgnore忽略字段、@JsonFormat处理日期格式），一定要在测试里覆盖这些场景，比如测试被忽略的字段是否真的不会被映射。
• 要测试边界情况：比如空的merchants集合、JSON里缺少某个可选字段、字段值为null的情况，确保你的对象能正确处理这些场景，不会抛出异常。
• 如果你的项目里自定义了RestTemplate的消息转换器（比如替换成Gson），那测试的时候就要用对应的序列化工具（比如Gson）来验证，而不是Jackson。

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