如何在Nim中根据OpenSSL版本导入对应哈希长度获取proc？

问题背景 #

要在Nim中基于OpenSSL实现兼容v1和v3版本的PBKDF2-HMAC-SHA256哈希函数，核心痛点是获取哈希长度时，两个版本的OpenSSL提供了不同的API：

• OpenSSL 1 使用EVP_MD_size函数
• OpenSSL 3 使用EVP_MD_get_size函数

直接静态导入两个函数会导致运行时错误——在OpenSSL 3环境中找不到EVP_MD_size符号，反之亦然。

解决方案1：运行时动态加载函数（推荐，自适应环境） #

通过动态加载OpenSSL库并根据版本查找对应函数指针，避免静态导入带来的符号解析错误。

实现代码 #

import std/[dynlib, openssl, strformat, options]

# 定义函数类型，匹配EVP_MD_size/EVP_MD_get_size的签名
type
  EVP_MDSizeProc = proc(md: EVP_MD): cint {.cdecl.}

# 存储动态加载的函数指针
var mdSizeProc: Option[EVP_MDSizeProc] = none(EVP_MDSizeProc)

# 获取OpenSSL主版本号
proc getOpenSSLMajorVersion(): uint =
  (getOpenSSLVersion() shr 28) and 0xF

# 初始化函数指针：根据版本加载对应函数
proc initMdSizeProc() =
  let libHandle = loadLib(DLLUtilName)
  if libHandle == nil:
    raise newException(ValueError, "无法加载OpenSSL工具库")

  let majorVer = getOpenSSLMajorVersion()
  let targetFunc =
    if majorVer == 3: "EVP_MD_get_size"
    elif majorVer == 1: "EVP_MD_size"
    else:
      raise newException(ValueError, fmt"仅支持OpenSSL 1和3版本，当前版本：{majorVer}")

  let funcAddr = symAddr(libHandle, targetFunc)
  if funcAddr == nil:
    raise newException(ValueError, fmt"无法从OpenSSL加载函数 {targetFunc}")

  mdSizeProc = some(cast[EVP_MDSizeProc](funcAddr))

# 统一对外的哈希长度获取函数
proc EVP_MD_size_fixed*(md: EVP_MD): cint =
  assert md != nil
  # 首次调用时初始化函数指针
  if mdSizeProc.isNone:
    initMdSizeProc()
  result = mdSizeProc.get()(md)

# 测试示例
proc EVP_sha256_fixed(): EVP_MD {.cdecl, dynlib: DLLUtilName, importc: "EVP_sha256".}
let digestFunc = EVP_sha256_fixed()
echo "SHA256哈希长度：", EVP_MD_size_fixed(digestFunc)

方案优势 #

• 完全自适应运行环境的OpenSSL版本，无需编译时指定参数
• 仅加载当前版本存在的函数符号，避免运行时符号缺失错误

解决方案2：编译时条件导入（适合固定环境编译） #

如果编译时已经明确目标环境的OpenSSL版本，可以通过条件编译选择导入对应函数。

实现代码 #

from std/openssl import DLLSSLName, EVP_MD, DLLUtilName

# 编译时通过-d:openssl1或-d:openssl3指定版本
when defined(openssl3):
  proc EVP_MD_size_fixed*(md: EVP_MD): cint {.cdecl, dynlib: DLLUtilName, importc: "EVP_MD_get_size".}
elif defined(openssl1):
  proc EVP_MD_size_fixed*(md: EVP_MD): cint {.cdecl, dynlib: DLLUtilName, importc: "EVP_MD_size".}
else:
  error("不支持的OpenSSL版本，请编译时添加-d:openssl1或-d:openssl3参数")

使用方式 #

编译时传入对应版本参数：

# 针对OpenSSL 1环境
nim c -d:openssl1 yourfile.nim

# 针对OpenSSL 3环境
nim c -d:openssl3 yourfile.nim

内容的提问来源于stack exchange，提问作者Philipp Doerner