最近在折腾 WebRTC 的编译相信不少朋友都遇到过这个让人有点头疼的警告CMake Warning at webrtc/CMakeLists.txt:28 (message): srtp 未找到。这个警告虽然不会立刻让编译停止但它意味着一个关键的安全库——SRTP安全实时传输协议——没有被正确找到后续链接或运行时很可能会出问题。今天我就把自己解决这个问题的完整过程梳理出来希望能帮你少走弯路。1. 问题根源CMake 的依赖查找机制首先我们得明白这个警告是怎么来的。这得从 CMake 的find_package命令说起。在 WebRTC 的 CMakeLists.txt 中通常会有一行类似find_package(SRTP REQUIRED)的指令。CMake 执行到这里时就会启动它的“寻宝”游戏按照一套既定的规则去系统里找 SRTP 库。查找路径CMake 会在一系列预定义的路径中搜索比如/usr/lib,/usr/local/lib以及由CMAKE_PREFIX_PATH等变量指定的路径。它还会查找名为FindSRTP.cmake或srtp-config.cmake的模块文件这些文件里包含了库的具体位置信息。pkg-config 辅助在类 Unix 系统上CMake 经常会借助pkg-config这个工具来查找库。pkg-config通过读取.pc文件通常由库的安装包提供来获取库的编译和链接参数。如果系统里没有安装 SRTP 的开发包比如libsrtp2-devpkg-config就找不到对应的.pc文件CMake 自然也就“找不到” SRTP 了。结果反馈当find_package找不到指定的包时如果指定了REQUIRED关键字CMake 会报错并停止如果没指定就像我们遇到的情况它会生成一个警告Warning告诉你没找到但编译流程会继续。这就是那个警告信息的由来。理解了原理解决起来就有方向了我们要么让 SRTP 出现在 CMake 的搜索路径里要么明确告诉 CMake 它在哪里。2. 解决方案一使用系统包管理器安装最快捷如果你是在 Ubuntu、Debian、CentOS 等主流 Linux 发行版上进行开发并且不需要特定版本的 SRTP那么使用系统自带的包管理器安装预编译版本是最快、最省事的方法。这相当于直接把“宝藏”放到了 CMake 默认会去搜索的“宝库”里。更新软件包列表首先确保你的包管理器数据库是最新的。# 对于 Ubuntu/Debian 系 sudo apt update # 对于 CentOS/RHEL/Fedora 系使用yum或dnf sudo yum check-update # 或 sudo dnf check-update安装 SRTP 开发包我们需要安装的不仅是运行时库更重要的是包含头文件.h和 pkg-config 文件.pc的“开发包”。# Ubuntu/Debian sudo apt install libsrtp2-dev # CentOS/RHEL (可能需要先启用EPEL仓库) sudo yum install libsrtp-devel # Fedora sudo dnf install libsrtp-devel验证安装安装完成后可以通过几个命令来验证。# 检查 pkg-config 是否能找到它 pkg-config --cflags --libs libsrtp2 # 如果成功会输出类似 -I/usr/include/srtp2 -lsrtp2 的信息 # 检查头文件是否存在 ls /usr/include/srtp2/ # 或 /usr/local/include/srtp2/ # 检查库文件是否存在 ls /usr/lib/x86_64-linux-gnu/libsrtp2.* # 路径可能因系统而异完成以上步骤后重新运行 WebRTC 的 CMake 配置命令比如cmake -B build那个“srtp 未找到”的警告就应该消失了。3. 解决方案二手动编译安装并配置最灵活有时候系统仓库里的版本太旧或者我们需要开启某些特定的编译选项又或者是在没有包管理器的环境下比如某些嵌入式系统或交叉编译手动编译安装就是最佳选择。这种方法让我们对库的版本和配置有完全的控制权。下载源码从官方仓库或发布页面获取 SRTP 源码。这里以 GitHub 上的 libsrtp 仓库为例。# 使用 git 克隆推荐便于获取最新版或特定分支 git clone https://github.com/cisco/libsrtp.git cd libsrtp # 或者下载稳定版的 tar 包 # wget https://github.com/cisco/libsrtp/archive/refs/tags/v2.5.0.tar.gz # tar -xzf v2.5.0.tar.gz # cd libsrtp-2.5.0配置与编译使用常见的configure make流程。--prefix参数指定了安装目录这里我们装到/usr/local这是许多编译工具默认的搜索路径。# 生成 Makefile并指定安装路径 ./configure --prefix/usr/local --enable-openssl # 编译源码。-j 参数指定并行编译的作业数能加快速度数字根据你的CPU核心数调整 make -j4 # 安装到系统。这会将库文件、头文件和 pkg-config 文件拷贝到 /usr/local 下 sudo make install更新动态链接库缓存安装到/usr/local/lib后可能需要更新系统的共享库缓存以便运行时能找到它。sudo ldconfig验证手动安装同样使用 pkg-config 验证。pkg-config --cflags --libs libsrtp2如果输出正确重新配置 WebRTC 即可。如果pkg-config还是找不到可能是因为它的搜索路径没包含/usr/local/lib/pkgconfig。可以临时设置PKG_CONFIG_PATH环境变量export PKG_CONFIG_PATH/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH然后再运行 CMake。4. 解决方案三修改 CMakeLists.txt 指定路径最直接如果你不想或不能将 SRTP 安装到系统目录比如在隔离的构建环境里或者有多个不同版本的 SRTP 需要切换那么直接修改 WebRTC 的构建脚本明确告诉 CMake 库在哪里是最直接有效的方法。定位关键代码打开触发警告的webrtc/CMakeLists.txt文件找到查找 SRTP 的部分通常在警告信息指出的第28行附近。指定路径变量在find_package(SRTP ...)命令之前通过set命令直接设置 CMake 用于查找的变量。最常用的是SRTP_ROOT或CMAKE_PREFIX_PATH。# 方法A设置 SRTP 专用的根目录变量 set(SRTP_ROOT /path/to/your/custom/srtp/install) # 例如set(SRTP_ROOT ${CMAKE_CURRENT_SOURCE_DIR}/../third_party/libsrtp) # 方法B将自定义路径添加到 CMake 的通用搜索前缀中 list(APPEND CMAKE_PREFIX_PATH /path/to/your/custom/srtp/install) find_package(SRTP REQUIRED)使用命令行参数更灵活的方式是在运行cmake命令时通过-D选项传递这些变量而无需修改源码。这对于 CI/CD 流水线特别有用。cmake -B build -D SRTP_ROOT/path/to/srtp -D CMAKE_PREFIX_PATH/path/to/srtp这样CMake 就会优先在你指定的路径下搜索 SRTP。5. 避坑指南常见问题与解决在实践以上方案时可能会遇到一些小坑这里提前预警一下。路径包含空格或特殊字符CMake 和 shell 对包含空格的路径解析有时会出问题。如果自定义路径中必须有空格请确保在 CMake 变量和 shell 命令中用引号括起来。# Shell 中 cmake -B build -D SRTP_ROOT/home/user/My Projects/srtp # CMakeLists.txt 中虽然最好避免 set(SRTP_ROOT /home/user/My Projects/srtp)最佳实践是依赖库的路径尽量使用无空格、无中文的纯英文路径。版本兼容性问题WebRTC 对 SRTP 的版本可能有特定要求。例如WebRTC 的某个版本可能要求 libsrtp2 而不是 libsrtp1。在手动编译前最好查看一下 WebRTC 源码中的README.md或DEPS文件确认其依赖的 SRTP 版本。安装错误版本可能导致链接错误或运行时崩溃。交叉编译环境在为 ARM 等平台交叉编译 WebRTC 时SRTP 也需要用对应的交叉编译工具链来编译。此时不能使用主机系统的包管理器安装。必须使用交叉编译工具链手动编译 SRTP并通过--host、--prefix参数指定目标平台和安装路径。在配置 WebRTC 的 CMake 时通过-D CMAKE_TOOLCHAIN_FILE指定工具链文件并在工具链文件或 CMake 命令中正确设置SRTP_ROOT或CMAKE_FIND_ROOT_PATH引导 CMake 到交叉编译的库目录中查找。6. 总结与延伸思考解决了这个具体的警告后我们可以再往远处想一步。如何纳入 CI/CD 早期检测这种依赖问题完全可以在持续集成流程的早期就被发现。我们可以在 CI 脚本的“安装依赖”阶段显式地检查关键库是否存在。例如在.gitlab-ci.yml或 GitHub Actions 的配置文件中加入一个检查步骤# 示例在 CI 脚本中检查 SRTP if ! pkg-config --exists libsrtp2; then echo ERROR: libsrtp2 not found. Installing... sudo apt-get install -y libsrtp2-dev fi # 或者如果使用自定义路径提前设置好 PKG_CONFIG_PATH 或 CMAKE_PREFIX_PATH这样一旦有新的构建环境缺少依赖CI 会立刻失败并给出明确提示而不是等到编译中途才报出警告。不同解决方案如何选择系统包安装适合个人开发、快速原型验证、以及生产服务器环境部署。优点是简单、稳定、易于维护随系统更新。缺点是对版本和编译选项控制力最弱。手动编译安装适合需要特定版本、特定功能如开启调试符号、使用特定加密后端、进行源码调试或目标系统没有包管理器的情况。灵活性最高但维护成本也稍高。修改 CMake 指定路径适合项目本身管理着第三方依赖如通过 git submodule 引入、需要在不同版本间切换、或者构建环境与运行环境隔离如使用 Docker 构建的场景。它将依赖关系更紧密地绑定在项目配置中。归根结底srtp 未找到这个警告是 WebRTC 复杂依赖关系的一个缩影。理解 CMake 的查找机制并掌握几种不同的依赖满足方式是搞定 C/C 项目编译环境的必备技能。希望这篇笔记能帮你顺利跨过这个坎把更多精力投入到 WebRTC 有趣的音视频开发本身。下次再遇到类似的“未找到”警告你应该能从容应对了吧