调用Apache EntityUtils.toString后JUnit Jupiter测试被跳过问题排查

可能原因 #

• 未处理检查型异常：EntityUtils.toString()会抛出IOException，若测试方法未声明抛出该异常，JUnit会直接终止测试流程，表现为代码执行到该行后"跳过"（实际是未捕获异常导致测试终止）。而Scanner解析时若已处理异常，就不会触发该问题。
• 字符编码不匹配：EntityUtils.toString()默认使用响应头指定的编码，若响应头未设置编码则默认用ISO-8859-1，若响应内容是其他编码（如UTF-8），会触发解码异常终止测试。Scanner可能使用系统默认编码刚好匹配，因此正常运行。
• 响应实体已被读取：若调用EntityUtils.toString()前已通过其他逻辑读取过实体内容，EntityUtils无法重复读取，会抛出异常导致测试终止。

解决办法 #

• 在测试方法中声明异常：
  修改测试方法签名，添加throws IOException，让JUnit捕获并展示异常信息，而非直接终止测试。同时使用try-with-resources自动关闭响应，避免资源泄漏：

  @Test
  void testHttpClientGet() throws IOException {
      HttpGet request = new HttpGet(url);
      try (CloseableHttpResponse response = httpClient.execute(request)) {
          HttpEntity entity = response.getEntity();
          System.out.println(EntityUtils.toString(entity));
      }
  }
  

• 指定明确字符编码：
  调用EntityUtils.toString()时手动指定编码（如UTF-8），规避编码不匹配问题：

  System.out.println(EntityUtils.toString(entity, StandardCharsets.UTF_8));
  

• 避免重复读取实体：
  若需要多次读取实体内容，先将其缓存为字节数组，后续基于字节数组处理：

  byte[] entityBytes = EntityUtils.toByteArray(entity);
  // 可多次使用该字节数组解析内容
  System.out.println(new String(entityBytes, StandardCharsets.UTF_8));
  

• 捕获异常并打印详情：
  若不想在方法上声明异常，可在代码中捕获IOException并打印堆栈信息，同时标记测试失败：

  try {
      System.out.println(EntityUtils.toString(entity));
  } catch (IOException e) {
      e.printStackTrace();
      fail("解析响应实体失败: " + e.getMessage());
  }
  

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