ZLMediaKit编译问题排查：OpenSSL版本不兼容导致WebRTC编译失败

问题背景

在使用ZLMediaKit进行编译时，开发者遇到了与OpenSSL版本相关的编译错误。错误主要集中在WebRTC模块的DtlsTransport.cpp文件中，表现为多个SSL相关函数未定义的情况。这类问题在跨平台编译或使用较旧系统环境时较为常见。

错误现象分析

编译过程中主要出现以下几类错误：

1. 函数未定义错误：

   • X509_up_ref未声明，系统建议使用X509_free
   • EVP_PKEY_up_ref未声明，系统建议使用EC_KEY_up_ref
   • DTLS_set_timer_cb在作用域中未声明

2. 警告信息：

   • 多行注释警告（相对次要）

这些错误表明编译环境中的OpenSSL版本与ZLMediaKit WebRTC模块所需的API不兼容。特别是X509_up_ref和EVP_PKEY_up_ref这两个函数，它们是OpenSSL 1.1.0及以上版本引入的新API。

根本原因

问题的根本原因在于：

1. 系统OpenSSL版本过旧：CentOS 7默认安装的OpenSSL版本通常为1.0.2系列，而ZLMediaKit的WebRTC模块需要至少OpenSSL 1.1.0以上版本提供的API支持。

2. API变更：OpenSSL 1.1.0进行了大量API改进，引入了引用计数管理等新功能，这些新API在老版本中不存在。

3. 编译选项影响：即使用户没有显式启用WebRTC，某些编译配置可能仍会尝试编译WebRTC相关代码。

解决方案

方案一：升级OpenSSL（推荐）

1. 下载OpenSSL源码（建议1.1.1k或更新版本）
2. 编译安装：

   ./config --prefix=/usr/local/openssl --openssldir=/usr/local/openssl
   make
   make install
   

3. 配置环境变量：

   export LD_LIBRARY_PATH=/usr/local/openssl/lib:$LD_LIBRARY_PATH
   export PATH=/usr/local/openssl/bin:$PATH
   

方案二：禁用WebRTC功能

如果不需要WebRTC功能，可以在编译时显式禁用：

cmake .. -DENABLE_WEBRTC=OFF -DENABLE_OPENSSL=OFF

方案三：使用Docker环境

考虑使用官方提供的Docker镜像或基于host模式的Docker容器进行编译，可以避免环境依赖问题。

技术细节说明

1. X509_up_ref：这是OpenSSL 1.1.0引入的函数，用于增加X509证书的引用计数，替代了原来的复杂引用管理方式。

2. EVP_PKEY_up_ref：同样在1.1.0版本引入，用于管理EVP_PKEY结构的引用计数。

3. DTLS_set_timer_cb：这是DTLS协议相关的定时器回调设置函数，不同版本OpenSSL中可能有不同的实现方式。

最佳实践建议

1. 版本一致性：建议使用与官方wiki文档一致的OpenSSL版本（如1.1.1k）进行编译。

2. 环境隔离：考虑使用虚拟环境或容器技术隔离编译环境，避免影响系统默认的OpenSSL。

3. 编译前检查：在编译前使用openssl version命令确认当前环境中的OpenSSL版本。

4. 错误排查：遇到类似问题时，首先检查错误信息中提到的未定义函数，查询它们引入的OpenSSL版本，然后相应调整环境。

总结

ZLMediaKit编译过程中遇到的OpenSSL相关问题通常源于版本不匹配。通过升级OpenSSL或禁用相关功能模块可以有效解决问题。对于生产环境，建议采用方案一升级OpenSSL，既能解决问题又能获得最新的安全补丁。对于快速测试环境，方案二的禁用方式更为便捷。理解这些底层依赖关系有助于更好地维护和部署ZLMediaKit流媒体服务器。