最近在折腾 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-dev），pkg-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 - 验证安装：安装完成后，可以通过几个命令来验证。
完成以上步骤后，重新运行 WebRTC 的 CMake 配置命令（比如# 检查 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.* # 路径可能因系统而异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 验证。
如果输出正确，重新配置 WebRTC 即可。如果pkg-config --cflags --libs libsrtp2pkg-config还是找不到，可能是因为它的搜索路径没包含/usr/local/lib/pkgconfig。可以临时设置PKG_CONFIG_PATH环境变量：
然后再运行 CMake。export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH
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 就会优先在你指定的路径下搜索 SRTP。cmake -B build -D SRTP_ROOT=/path/to/srtp -D CMAKE_PREFIX_PATH=/path/to/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 到交叉编译的库目录中查找。
- 使用交叉编译工具链手动编译 SRTP，并通过
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 有趣的音视频开发本身。下次再遇到类似的“未找到”警告，你应该能从容应对了吧？
