在 spring boot 中,全局异常处理无法直接通过 `@controlleradvice` 捕获由底层 http 客户端(如 `resttemplate` 或 `webclient`)发起请求时因证书验证失败抛出的运行时异常。这是因为这些异常通常发生在控制器方法执行之前或之外,属于网络层或框架层的错误。正确的做法是在配置 http 客户端时,自定义 `errorhandler` 或实现 `responseerrorhandler` 接口,将证书相关的异常转换为特定的业务异常或状态码,从而让全局异常处理器能够统一拦截并返回标准化的 json 响应。

如何配置 RestTemplate 以捕获 SSL 证书异常
要捕获证书验证异常,需要创建一个实现了 `ResponseErrorHandler` 接口的自定义类,并在其中重写 `hasError` 和 `handleError` 方法。当 `RestTemplate` 遇到 SSLHandshakeException 或其他 IO 异常时,会调用这些方法。你可以在这里记录日志、转换异常类型,或者简单地让默认行为继续,但关键在于确保异常能被抛出到上层,以便被全局异常处理器捕获。如果希望完全控制响应,可以在 `handleError` 中抛出自定义的 `CertificateValidationException`。

import org.springframework.http.client.ClientHttpResponse;
import org.springframework.web.client.ResponseErrorHandler;
import java.io.IOException;
public class CustomErrorHandler implements ResponseErrorHandler {
private final ResponseErrorHandler defaultHandler = new DefaultResponseErrorHandler();
@Override
public boolean hasError(ClientHttpResponse response) throws IOException {
return defaultHandler.hasError(response);
}
@Override
public void handleError(ClientHttpResponse response) throws IOException {
try {
defaultHandler.handleError(response);
} catch (Exception e) {
// 如果是证书相关异常,可以包装成自定义异常
if (e.getCause() instanceof javax.net.ssl.SSLHandshakeException) {
throw new CertificateValidationException("SSL Certificate Validation Failed", e);
}
throw e;
}
}
}
接下来,在配置类中将这个自定义错误处理器注入到 `RestTemplateBuilder` 中。这样,任何使用该 `RestTemplate` 发起的请求都会经过这个错误处理器。如果发生证书错误,它会抛出 `CertificateValidationException`,这将被全局异常处理器捕获。
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestTemplate;
import org.springframework.web.client.RestTemplateBuilder;
@Configuration
public class RestTemplateConfig {
@Bean
public RestTemplate restTemplate(RestTemplateBuilder builder) {
return builder.errorHandler(new CustomErrorHandler()).build();
}
}
最后,定义一个全局异常处理器来捕获 `CertificateValidationException`。使用 `@RestControllerAdvice` 注解,并指定 `@ExceptionHandler(CertificateValidationException.class)`。在这个方法中,你可以返回一个统一的错误响应对象,包含错误码、消息和时间戳。
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(CertificateValidationException.class)
public ResponseEntity<errorresponse> handleCertificateException(CertificateValidationException ex) {
ErrorResponse error = new ErrorResponse(
HttpStatus.BAD_GATEWAY.value(),
"Certificate Validation Error",
ex.getMessage()
);
return new ResponseEntity(error, HttpStatus.BAD_GATEWAY);
}
}</errorresponse>
如何处理 WebClient 中的证书验证异常
对于基于 Reactor 的 `WebClient`,处理方式略有不同。你需要自定义 `ExchangeFilterFunction` 或在构建 `WebClient` 时配置 `HttpClient`。由于 `WebClient` 是异步非阻塞的,异常处理需要通过 `onErrorResume` 或类似的机制来处理。然而,更推荐的方式是在创建 `WebClient` 实例时,通过 `HttpClient` 配置自定义的 `SslContext` 或使用 `ConnectionProvider` 来监控连接状态。如果必须捕获异常,可以在 `WebClient` 的过滤器中检查响应状态,或者在调用链中使用 `Mono.onErrorResume` 来捕获特定异常。

import io.netty.handler.ssl.SslContext;
import io.netty.handler.ssl.SslContextBuilder;
import io.netty.handler.ssl.util.InsecureTrustManagerFactory;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.web.reactive.function.client.WebClient;
import reactor.core.publisher.Mono;
import javax.net.ssl.SSLException;
public class WebClientConfig {
public WebClient createSecureWebClient() {
SslContext sslContext = null;
try {
// 注意:生产环境应使用受信任的证书,这里仅用于演示
sslContext = SslContextBuilder.forClient()
.trustManager(InsecureTrustManagerFactory.INSTANCE)
.build();
} catch (SSLException e) {
e.printStackTrace();
}
return WebClient.builder()
.clientConnector(new ReactorClientHttpConnector(HttpClient.create()
.secure(t -> t.sslContext(sslContext))))
.defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
.build();
}
}
在使用 `WebClient` 进行请求时,可以通过 `onErrorResume` 来捕获 `SSLException` 并将其转换为自定义异常,从而让全局异常处理器能够捕获它。例如:
webClient.get()
.uri("https://example.com/api")
.retrieve()
.bodyToMono(String.class)
.onErrorResume(SSLException.class, ex -> {
throw new CertificateValidationException("SSL Error", ex);
});
证书验证失败时的具体响应内容是什么
当证书验证失败时,全局异常处理器会返回一个包含特定错误码和详细信息的 JSON 对象。根据前面定义的 `GlobalExceptionHandler`,响应的状态码为 502 Bad Gateway,错误类型为 "Certificate Validation Error",消息部分则包含具体的异常信息,如 "SSL Certificate Validation Failed"。这种结构化的响应有助于前端或调用方快速识别问题并进行相应的处理,例如提示用户检查服务器证书或联系管理员。











