当 OkHttp 因 SSL 证书校验失败（如哈希不匹配）而中断请求时，chain.proceed(request) 会直接抛出异常而非返回 Response；本文详解如何通过 try-catch 捕获该异常、提取关键错误信息，并安全地向 JS 层透传告警。
当 okhttp 因 ssl 证书校验失败（如哈希不匹配）而中断请求时，`chain.proceed(request)` 会直接抛出异常而非返回 `response`；本文详解如何通过 try-catch 捕获该异常、提取关键错误信息，并安全地向 js 层透传告警。
在 React Native 中实现 SSL Pinning（证书固定）是提升网络通信安全性的重要手段，尤其在 Android 原生层通过 OkHttp 配置 CertificatePinner 可有效防御中间人攻击。然而，一个常见痛点是：当预置的证书哈希与服务端实际证书不匹配（例如测试环境误配、证书轮换未同步或主动注入攻击），OkHttp 不会返回常规 HTTP 响应，而是在 chain.proceed() 执行阶段直接抛出运行时异常——此时拦截器中 res.toString() 等后续逻辑根本不会执行，导致开发者无法感知失败原因。
根本原因在于：SSL Pinning 属于 TLS 握手层校验，发生在网络请求真正发出之前。一旦校验失败（如 javax.net.ssl.SSLPeerUnverifiedException: Certificate pinning failure），OkHttp 会立即终止流程并向上抛出异常，跳过整个响应处理链。因此，chain.proceed(request) 永远不会返回 null 或空 Response，而是必然抛出异常——这正是原始代码中 System.out.println("Intercepted response: ...") 未被打印的根本原因。
✅ 正确做法：在拦截器中对 chain.proceed() 显式包裹 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());
try {
Response response = chain.proceed(request);
// SSL 校验通过，正常返回响应
System.out.println("My Client::: Intercepted response: " + response.code() + " " + response.message());
return response;
} catch (IOException e) {
// 捕获所有网络/SSL 相关异常（包括 CertificatePinningFailure）
String errorMsg = e.getMessage() != null ? e.getMessage() : e.getClass().getSimpleName();
System.err.println("My Client::: SSL Pinning FAILED for " + request.url() + " — " + errorMsg);
// 【关键】可在此处触发 RN 事件通知 JS 层（需配合 Native Module）
//例如：ReactContext reactContext = ...;
// reactContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
// .emit("SSL_PINNING_ERROR",
// new WritableNativeMap().putString("url", request.url().toString())
// .putString("error", errorMsg));
// 注意：必须重新抛出异常或返回兜底 Response，否则 Axios 将收不到错误
throw e; // 推荐：保持异常链完整，使 Axios 能正确触发 .catch()
}
}
}⚠️ 重要注意事项：
- 不要静默吞掉异常：若 catch 后不 throw e 或不返回有效 Response，OkHttp 会因无返回值而崩溃，或 Axios 收不到错误回调，导致前端请求“假死”。
- 异常类型识别：SSL Pinning 失败通常抛出 javax.net.ssl.SSLPeerUnverifiedException，其消息体明确包含 "Certificate pinning failure" 及具体域名、预期/实际哈希等信息，可直接解析用于日志或上报。
- 与 React Native 集成：建议在 catch 块中通过 DeviceEventManagerModule 向 JS 发送自定义事件（如 "SSL_PINNING_ERROR"），并在 JS 层监听该事件实现统一告警、降级策略（如提示用户检查网络、跳转帮助页）。
- 避免在拦截器中阻塞主线程：日志打印或事件发射均为轻量操作；若需复杂处理（如上报至监控平台），应切至后台线程。
? 补充方案：若希望完全规避原生层配置，可考虑使用 react-native-ssl-pinning（支持 iOS/Android，兼容 Axios/Fetch），它封装了 OkHttp 和 NSURLSession 的 pinning 逻辑，并提供 JS 层可监听的失败回调，显著降低原生开发成本。
总结：SSL Pinning 失败的本质是 TLS 层异常，而非 HTTP 层响应；唯一可靠捕获方式是在 chain.proceed() 外层添加 try-catch。此举不仅解决调试可见性问题，更是构建健壮安全通信链路的关键一环——让每一次证书校验失败都“可感、可观、可控”。
