Spring Boot 3.4.1升级后健康检查HTTP状态码异常求助

问题描述 #

我们正在从Spring Boot 3.2.5升级至3.4.1版本，作为API网关的Client Service API负责转发请求，并通过调用目标微服务的/check-status端点执行健康检查。升级后出现异常行为：

• 当目标微服务未激活时，网关本该返回HTTP 500状态码，但实际返回200 OK
• 日志中出现报错：Looks like the client has gone away: org.springframework.web.client.ResourceAccessException: I/O error on POST request...
• 对比Spring Boot 3.2.7版本，该场景会正确触发错误处理流程并返回500状态码，且3.4.1的官方变更日志未提及相关改动。

相关核心代码：

if ("true".equalsIgnoreCase(sslEnabled.trim())) {
   logger.info("Request will be forwarded to: " + "https://" + serviceUrl);
   return restTemplate.postForObject("https://" + serviceUrl, reqObj, String.class);
}
logger.info("Request will be forwarded to: " + "http://" + serviceUrl);
return restTemplate.postForObject("http://" + serviceUrl, reqObj, String.class);

排查方向与解决方案 #

1. 检查RestTemplate错误处理器变更 #

Spring Boot 3.4.1依赖的Spring Framework 6.2.x可能调整了RestTemplate的默认错误处理逻辑，导致ResourceAccessException未被正确映射为500状态码。

• 排查项目中是否自定义了ResponseErrorHandler，升级后是否因依赖冲突或配置覆盖导致默认处理器失效。
• 显式配置错误处理器，确保I/O异常被正确捕获：

  @Bean
  public RestTemplate restTemplate() {
      RestTemplate restTemplate = new RestTemplate();
      restTemplate.setErrorHandler(new DefaultResponseErrorHandler() {
          @Override
          public void handleError(ClientHttpResponse response) throws IOException {
              super.handleError(response);
          }
  
          @Override
          public boolean hasError(ClientHttpResponse response) throws IOException {
              return super.hasError(response);
          }
      });
      return restTemplate;
  }
  

• 或在业务代码中手动捕获ResourceAccessException，主动触发500响应：

  try {
      // 原RestTemplate调用逻辑
  } catch (ResourceAccessException e) {
      logger.error("Health check failed for service: {}", serviceUrl, e);
      throw new RuntimeException("Service unavailable", e);
      // 配合全局异常处理器将RuntimeException映射为500
  }
  

2. 验证底层HTTP客户端的异常处理 #

Spring Framework 6.2.x对JDK HttpClient的适配可能有变更，导致连接拒绝/超时的异常未向上抛出。

• 尝试切换为Apache HttpClient作为RestTemplate的底层客户端，验证是否修复问题：

  @Bean
  public RestTemplate restTemplate() {
      HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory();
      return new RestTemplate(factory);
  }
  

  需确保引入spring-boot-starter-httpclient依赖。

3. 检查全局异常处理器有效性 #

升级后@RestControllerAdvice等全局异常处理器的优先级或逻辑可能被改变，导致ResourceAccessException未被捕获。

• 确认全局异常处理器中是否包含对ResourceAccessException或其父类RestClientException的处理：

  @RestControllerAdvice
  public class GlobalExceptionHandler {
      @ExceptionHandler(ResourceAccessException.class)
      public ResponseEntity<String> handleResourceAccessException(ResourceAccessException e) {
          return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Service health check failed");
      }
  }
  

• 排查是否有其他异常处理器提前捕获了该异常并返回200。

4. 排查健康检查相关配置变更 #

若使用Spring Boot Actuator的健康检查功能，3.4.x可能调整了端点的异常处理逻辑：

• 检查application.yml/application.properties中management.health.*相关配置，确认是否存在抑制异常暴露的参数。
• 验证自定义健康检查端点的异常处理逻辑，确保升级后未失效。

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