React-Native-WebRTC在Android平台上音频呼叫崩溃问题分析与解决方案

问题背景

在使用React-Native-WebRTC与SIP.js构建Android语音通话应用时，开发者在进行外呼音频通话时遇到了严重的崩溃问题。该问题表现为在设置本地描述(setLocalDescription)阶段，应用会突然崩溃，在调试模式下会导致整个Metro进程终止，而在生产环境中则表现为应用无响应。

崩溃现象分析

从日志中可以观察到以下关键现象：

1. 应用能够成功建立WSS连接并完成SIP注册
2. 本地媒体流获取和交换过程正常
3. 音轨添加操作顺利完成
4. SDP提议交换和接受过程无异常
5. 在调用setLocalDescription时发生致命崩溃

崩溃日志显示系统抛出了SIGABRT信号，错误代码为-1(SI_QUEUE)，同时伴随有/proc文件系统读取失败的记录。这表明底层WebRTC库(libjingle)在尝试访问系统资源时遇到了权限问题。

根本原因

经过深入排查，发现问题根源在于Android应用缺少必要的运行时权限。具体来说，应用需要以下权限才能正常进行WebRTC通话：

1. 硬件特性声明：

<uses-feature android:name="android.hardware.microphone" />
<uses-feature android:name="android.hardware.audio.output" />

2. 运行时权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

其中最关键的是ACCESS_NETWORK_STATE权限，缺少此权限会导致ConnectivityService抛出SecurityException，进而引发底层WebRTC库的崩溃。

解决方案

要解决此问题，开发者需要在AndroidManifest.xml文件中添加上述所有权限声明。具体步骤如下：

1. 打开项目中的AndroidManifest.xml文件
2. 在标签内添加以下权限声明：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

3. 添加硬件特性声明：

<uses-feature android:name="android.hardware.microphone" />
<uses-feature android:name="android.hardware.audio.output" />

4. 对于Android 6.0及以上版本，还需要在运行时请求录音权限

补充说明

1. 对于使用自签名证书的情况，需要为release构建添加与debug构建相同的证书豁免配置
2. 在iOS平台上，需要类似的权限配置，但具体权限名称和申请方式会有所不同
3. 建议在应用启动时检查并请求所有必要权限，避免运行时崩溃

最佳实践建议

1. 权限检查：在发起通话前，应该检查所有必要权限是否已授予
2. 错误处理：对WebRTC操作添加适当的错误处理逻辑，避免应用崩溃
3. 日志记录：在关键节点添加详细的日志记录，便于问题排查
4. 测试验证：在debug和release模式下分别进行完整的功能测试

通过正确配置权限和遵循上述最佳实践，可以确保React-Native-WebRTC应用在Android平台上稳定运行语音通话功能。