如何构建支持H264的node-webrtc？自建wrtc.node替换后运行报错

核心问题定位 #

• 构建模式默认不匹配：npm源提供的官方预编译包为Release构建版本，开启了二进制优化、调试符号剥离、未使用代码裁剪逻辑；本地直接执行./node_modules/.bin/ncmake build默认走Debug构建流程，会打包大量调试符号、未裁剪的依赖代码，这也是你哪怕不加任何编译参数，打出来的wrtc.node体积比官方预编译版大70%的核心原因。Debug构建的二进制和项目运行时兼容链路不匹配，直接替换文件必然触发运行错误。
• 编译参数注入时机错误：你在rebuild命令后传递的H264相关编译参数，没有对齐node-webrtc的源码构建流程要求。这类和WebRTC源码、FFmpeg编解码相关的编译参数，需要在拉取WebRTC源码、首次生成GN构建配置的阶段注入，不是在cmake构建的后续步骤传递，等于你配置的专有编解码开关根本没实际生效，编译出来的二进制依赖链路和运行时期望不匹配。
• 开发环境工具链版本不兼容：
  • 你当前使用的Python 2.7.18 已和node-webrtc当前分支的GN工具链版本要求不匹配，旧版本Python运行GN脚本时会静默跳过部分依赖裁剪配置，把多余的静态依赖全部链接到最终产物中
  • GCC 9.3 编译生成的原生模块，和官方预编译包使用的低版本GCC编译的运行时库存在libstdc++ ABI版本差异，哪怕是同模式的构建产物，直接替换到现有项目中也会因为符号依赖不匹配崩溃
• 替换文件时的依赖不完整：wrtc.node不是可独立运行的二进制文件，它和node-webrtc包目录下build路径中的其他动态库是配套匹配的，仅单独替换单个wrtc.node文件，没有同步替换同目录下的配套依赖，也会直接触发运行错误。

可落地的修正步骤 #

• 构建时显式指定Release模式：执行./node_modules/.bin/ncmake build --release，构建完成后对产物做符号剥离，对比体积和官方预编译版的差值
• 提前注入编解码相关编译参数：拉取node-webrtc源码后，在执行依赖安装、拉取WebRTC源码、生成GN配置的阶段，通过环境变量传入H264支持所需的编译参数，不要等到cmake构建阶段再传递参数
• 对齐官方构建的工具链版本：换用匹配版本的GCC、适配的Python3版本完成编译（不再使用Python2，当前新版工具链已逐步淘汰Python2支持）
• 替换构建产物时，将build目录下的所有配套文件全部替换，不要仅单独替换单个wrtc.node文件

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