如何在addon.cc（基于Nan）中捕获OpenSSL调用引发的崩溃异常

问题背景 #

通过Nan编写的addon.cc调用OpenSSL的解密、签名、验签方法，反复调用后会出现解密/验签错误，多次触发后服务器崩溃，且Nan::TryCatch无法捕获这类异常。

崩溃时的异常信息（中文翻译） #

错误: 8668943040:error:21070073:PKCS7 例程:PKCS7_dataDecode:没有匹配的收件人证书:../deps/openssl/openssl/crypto/pkcs7/pk7_doit.c:491:
8668943040:error:21072077:PKCS7 例程:PKCS7_decrypt:解密错误:../deps/openssl/openssl/crypto/pkcs7/pk7_smime.c:500:

在TLSSocket实例上触发了'error'事件:
    在 TLSSocket._emitTLSError (_tls_wrap.js:893:10)
    在 TLSWrap.onerror (_tls_wrap.js:416:11) {
  library: 'PKCS7 routines',
  function: 'PKCS7_dataDecode',
  reason: 'no recipient matches certificate',
  code: 'ERR_SSL_NO_RECIPIENT_MATCHES_CERTIFICATE'
}

解决方案 #

Nan::TryCatch仅能捕获JavaScript层面的异常，而OpenSSL的错误属于C层错误，不会自动转为JS异常，甚至可能直接触发崩溃。需从主动检查返回值、捕获C层错误转JS异常、确保资源安全三个核心方向处理：

1. 强制检查OpenSSL函数返回值 #

所有OpenSSL核心函数（如PKCS7_decrypt、EVP_VerifyFinal等）都会返回明确状态值（通常1为成功，0/-1为失败），调用后必须立即校验返回值，失败则终止流程并处理错误。

示例代码：

// 调用OpenSSL解密函数
int result = PKCS7_decrypt(p7, pkey, cert, out, flags);
if (result != 1) {
  HandleOpenSSLError("PKCS7解密失败");
  return; // 终止当前Addon方法执行
}

2. 捕获OpenSSL错误栈并转为JS异常 #

OpenSSL通过线程局部错误队列存储错误信息，需用ERR_get_error()循环取出所有错误，拼接后用Nan创建JS Error对象抛出，让上层JS代码可捕获，避免服务器崩溃。

实现错误处理函数：

void HandleOpenSSLError(const char* prefix) {
  Nan::HandleScope scope;
  std::string errorMsg = prefix;
  unsigned long errCode;

  // 循环取出所有OpenSSL错误
  while ((errCode = ERR_get_error()) != 0) {
    char errBuf[1024];
    ERR_error_string_n(errCode, errBuf, sizeof(errBuf));
    errorMsg += "\n";
    errorMsg += errBuf;
  }

  // 抛出JS异常
  Nan::ThrowError(Nan::New(errorMsg).ToLocalChecked());
}

3. 严格管理OpenSSL资源 #

崩溃的核心诱因往往是资源泄漏或重复使用无效资源，每次调用OpenSSL方法后，必须用对应释放函数清理资源：

• PKCS7对象：PKCS7_free(p7);
• EVP_PKEY对象：EVP_PKEY_free(pkey);
• X509证书：X509_free(cert);
• BIO对象：BIO_free_all(bio);

示例：

PKCS7* p7 = PKCS7_decrypt(...);
if (!p7) {
  HandleOpenSSLError("PKCS7解析失败");
  return;
}

// 使用p7处理数据...

// 最后必须释放资源
PKCS7_free(p7);

4. 处理线程安全问题 #

Node.js Addon可能在多线程环境（如Worker线程）执行，OpenSSL错误队列是线程局部的，需在每个线程调用OpenSSL前调用ERR_clear_error()清空错误队列，避免残留错误干扰后续调用。

在Addon方法开头添加：

ERR_clear_error();

5. C++层面全局异常捕获 #

若仍存在未捕获的C层崩溃（如空指针访问），可在Addon方法外层包裹C++的try-catch，捕获后转为JS异常：

NAN_METHOD(Decrypt) {
  Nan::HandleScope scope;
  try {
    // 所有OpenSSL调用逻辑...
  } catch (const std::exception& e) {
    Nan::ThrowError(Nan::New(std::string("C++异常: ") + e.what()).ToLocalChecked());
    return;
  } catch (...) {
    Nan::ThrowError(Nan::New("未知C++异常").ToLocalChecked());
    return;
  }
}

关键注意事项 #

• 绝不忽略任何OpenSSL函数的返回值，包括辅助函数
• 资源释放建议用C++智能指针自定义删除器，确保中间出错时也能自动清理
• 测试时需模拟异常场景（如无效证书、损坏密文），验证错误捕获逻辑有效性

内容的提问来源于stack exchange，提问作者Vimal Kumar Sindh