在 spring boot 中,全局异常处理无法直接捕获 ssl 握手异常,因为这类错误发生在 http 请求到达 controller 之前。必须通过配置 tomcat 容器的自定义 errorreportvalve 来拦截底层抛出的异常。

为什么 @ControllerAdvice 抓不到 SSL 异常
@ControllerAdvice 和 @ExceptionHandler 只能处理 DispatcherServlet 分发给 Controller 后的业务逻辑异常。SSL 握手失败(如 javax.net.ssl.SSLHandshakeException)通常由底层的 Tomcat Connector 或 Servlet 容器在解析请求头或建立连接时抛出,此时请求尚未进入 Spring MVC 的调用链,因此会被容器视为致命错误并返回默认的 500 页面。

如何配置自定义 ErrorReportValve
要捕获这些异常,需要向 Tomcat 注册一个自定义的 ErrorReportValve。该 Valve 会接管容器的错误报告流程,从而有机会捕获并处理 SSL 相关的 IOException 或 RuntimeException。
import org.apache.catalina.valves.ErrorReportValve;
import org.apache.coyote.RequestInfo;
import javax.servlet.ServletException;
import java.io.IOException;
public class CustomErrorValve extends ErrorReportValve {
@Override
public void invoke(Request request, Response response) throws IOException, ServletException {
try {
super.invoke(request, response);
} catch (Exception e) {
// 在这里处理 SSL 异常
if (e.getMessage() != null && e.getMessage().contains("SSL")) {
response.sendError(400, "SSL Handshake Failed");
} else {
throw e;
}
}
}
}接下来需要在 Spring Boot 中将该 Valve 注册到 Tomcat 容器中。可以通过实现 WebServerFactoryCustomizer 接口来完成这一配置。
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.stereotype.Component;
@Component
public class CustomTomcatConfig implements WebServerFactoryCustomizer<TomcatServletWebServerFactory> {
@Override
public void customize(TomcatServletWebServerFactory factory) {
factory.addValves(new CustomErrorValve());
}
}这样配置后,当发生 SSL 握手异常时,自定义的 Valve 将捕获异常并返回指定的错误信息,而不是默认的 500 页面。

验证 SSL 握手异常的捕获效果
为了验证上述配置是否生效,可以启动应用并使用 curl 发送一个无效的 SSL 请求。如果配置正确,应该能够看到自定义的错误响应。
curl -k https://localhost:8443/api/test
预期结果:如果 SSL 握手失败,服务器将返回 400 状态码及消息 "SSL Handshake Failed"。否则,将返回默认的 500 错误或正常的业务响应。


















