CMake构建TDLib源码时如何指定适配Node.js的OpenSSL版本

前置版本匹配规则 #

先执行node -v确认当前Node.js主版本，必须严格匹配对应OpenSSL版本，否则编译完成后运行会出现SSL报错、段错误等异常：

• Node.js ≥17：必须搭配OpenSSL 3.0.x版本编译
• 10 ≤ Node.js <17：必须搭配OpenSSL 1.1.x版本编译
• Node.js <10：必须搭配OpenSSL 1.0.x版本编译

Alpine分支和内置OpenSSL版本对应关系：3.17及以后版本默认源提供OpenSSL 3.0，3.10~3.16版本默认源提供OpenSSL 1.1，更早版本默认源提供OpenSSL 1.0。如果当前Alpine版本内置OpenSSL和要求不匹配，先切换到对应版本的Alpine软件源，禁止混装多个版本的OpenSSL开发包。

操作步骤 #

1. 安装编译依赖
   执行以下命令安装基础编译工具链和对应版本的OpenSSL开发包：

apk add --no-cache gperf make cmake clang linux-headers zlib-dev openssl-dev git

2. 准备源码与构建目录
   获取TDLib官方最新主线源码，进入源码根目录后创建独立的build目录存放构建产物，避免污染源码文件：

mkdir build && cd build

3. CMake配置
   执行以下配置命令，开启共享库编译、关闭不需要的JNI组件，适配Node.js动态链接要求：

cmake .. -DCMAKE_BUILD_TYPE=Release -DTD_ENABLE_JNI=OFF -DBUILD_SHARED_LIBS=ON

OpenSSL配置说明：
CMake全局环境变量列表中没有直接以SSL命名的编译控制项，OpenSSL的依赖定位由CMake内置的FindOpenSSL模块和TDLib构建脚本共同处理，通过OPENSSL_ROOT_DIR参数指定路径即可。如果手动编译安装了非系统默认路径的对应版本OpenSSL，只需要在上面的cmake命令末尾追加-DOPENSSL_ROOT_DIR=<OpenSSL安装根目录的绝对路径>，不需要额外配置其他带SSL字样的变量。

4. 编译与安装
   执行编译命令，-j后的参数为并行编译任务数，设置为CPU核心数时编译速度最快：

make -j$(nproc)
make install
ldconfig /usr/local/lib

避坑提示 #

• 编译前如果存在之前失败的构建记录，必须先删除整个build目录重新配置，CMake会缓存之前的依赖查找结果，增量调整配置大概率会出现版本不匹配问题
• Alpine使用musl libc，不要替换为glibc版本的OpenSSL库，必须使用Alpine源提供的对应版本openssl-dev包参与编译，否则会出现链接错误
• 后续如果升级Node.js大版本，必须重新按照版本匹配规则清理构建目录重新编译TDLib，不能直接复用之前编译好的动态库

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