当 OkHttp 因 SSL 证书校验失败（如哈希不匹配）而中断请求时，chain.proceed(request) 会直接抛出异常而非返回 Response 对象；本文详解如何通过 try-catch 捕获该异常、提取关键错误信息，并安全地向 JS 层透传警告，实现可控的 SSL pinning 故障诊断。
当 okhttp 因 ssl 证书校验失败（如哈希不匹配）而中断请求时，`chain.proceed(request)` 会直接抛出异常而非返回 `response` 对象；本文详解如何通过 `try-catch` 捕获该异常、提取关键错误信息，并安全地向 js 层透传警告，实现可控的 ssl pinning 故障诊断。
在 React Native 中集成原生 SSL Pinning（如使用 OkHttp 的 CertificatePinner）时，一个常见但易被忽视的问题是：当证书校验失败（例如配置了错误的公钥哈希），网络请求不会进入拦截器的「响应处理逻辑」，而是直接在 chain.proceed() 处抛出异常。此时若未显式捕获，应用可能静默失败或崩溃，开发者难以定位是网络问题、服务端变更，还是客户端 SSL 配置错误。
根本原因在于：OkHttp 的 CertificatePinner 在连接建立阶段（TLS 握手后、HTTP 请求发送前）即完成证书链校验。一旦校验失败（如 HostnameVerifier 或 PinnedCertificates 不匹配），它会立即抛出 javax.net.ssl.SSLPeerUnverifiedException（或其子类，如 java.security.cert.CertificateException），该异常发生在 chain.proceed() 内部，拦截器后续代码（包括 res.toString()）根本不会执行。
✅ 正确做法：将 chain.proceed(request) 包裹在 try-catch 块中，主动捕获并处理 SSL 相关异常：
public class CustomInterceptor implements Interceptor {
@Override
public Response intercept(Chain chain) throws IOException {
Request request = chain.request();
System.out.println("My Client::: Intercepted request: " + request.url());
Response response = null;
try {
response = chain.proceed(request);
System.out.println("My Client::: Success - Response code: " + response.code());
return response;
} catch (SSLPeerUnverifiedException e) {
// ✅ 捕获 SSL Pinning 核心异常
String errorMsg = "SSL Pinning failed for " + request.url()
+ ": " + e.getMessage();
System.err.println("My Client::: SSL ERROR - " + errorMsg);
// 可选：向 JS 层上报（需配合 React Native Bridge）
// SSLPinErrorReporter.reportError(request.url().toString(), e.getMessage());
// ⚠️ 注意：此处不能 return null！需构造兜底 Response 避免上层 NPE
return new Response.Builder()
.request(request)
.protocol(Protocol.HTTP_1_1)
.code(599) // 自定义错误码，如 599 表示 SSL Pinning Failure
.message("SSL Pinning Rejected")
.body(ResponseBody.create(
MediaType.get("text/plain"),
"SSL certificate validation failed. Please check app configuration."
))
.build();
} catch (IOException e) {
// 兜底捕获其他网络异常（超时、连接重置等）
System.err.println("My Client::: Network error: " + e.getMessage());
throw e; // 或按需处理
}
}
}? 关键注意事项：
- 必须捕获 SSLPeerUnverifiedException：这是 OkHttp 在证书校验失败时抛出的标准异常类型，优先于通用 Exception 捕获，便于精准识别 SSL 问题。
- 禁止返回 null：OkHttp 拦截器契约要求 intercept() 必须返回非空 Response。若仅打印日志后不返回，会导致 NullPointerException 级联崩溃。
- 构造有意义的兜底响应：使用 Response.Builder 创建含自定义状态码（如 599）、明确 message 和 body 的响应，便于前端 Axios 统一拦截处理（例如通过 response.status === 599 触发用户提示或埋点上报）。
- 避免日志泄露敏感信息：e.getMessage() 可能包含证书指纹等调试信息，生产环境建议脱敏或仅记录摘要。
- 补充方案建议：若希望更深度集成，可借助 ReactContext 通过 NativeModule 将错误事件主动发送至 JS 层，实现“原生报错 → JS 提示用户更新 App”的闭环体验。
通过以上方式，你不仅能可靠捕获 SSL Pinning 失败事件，还能将其转化为可观测、可运营的客户端质量指标，大幅提升混合应用在证书轮换、中间人攻击防护等场景下的健壮性与可维护性。
