Expo SDK 53升级至55后iOS真机WebRTC接收音频无输出问题排查

一、iOS原生层面可能的触发条件 #

以下原生场景会导致「RTP包正常接收、轨道活跃但物理设备无音频输出」的现象：

• 音频会话配置冲突：Expo 55升级后可能修改了AVAudioSession默认类别/模式，WebRTC所需的Playback或PlayAndRecord类别被覆盖为不支持播放的配置，物理设备对会话状态的校验比模拟器严格。
• 音频路由异常：WebRTC默认将音频路由到听筒，但物理设备处于静音状态、听筒故障，或Expo升级后路由切换逻辑失效，导致播放路径被阻断。
• 解码兼容性问题：iOS物理设备的Opus解码器与Expo 55引入的WebRTC底层版本存在兼容性问题，RTP包接收正常但解码后无法输出到硬件。
• 权限状态异常：Expo 55修改了权限请求流程，表面上音频权限已授予，但实际会话未获得硬件访问权限（比如后台音频模式未正确配置）。
• RTCAudioSession激活失效：react-native-webrtc依赖的RTCAudioSession激活时机或方式被Expo 55的变更打断，物理设备需要显式激活会话才能播放音频，模拟器则无此限制。

二、react-native-webrtc调试路径与修复方案 #

调试步骤 #

1. 检查音频会话状态：通过react-native-incall-manager或原生代码打印AVAudioSession的类别、模式、激活状态，确认是否为WebRTC所需的Playback/PlayAndRecord类别、VoiceChat模式。
2. 监听会话通知：添加AVAudioSessionInterruptionNotification、AVAudioSessionRouteChangeNotification监听，排查是否存在音频中断或路由切换异常。
3. 验证硬件输出：用AVAudioPlayer播放本地音频，确认设备硬件输出正常，排除硬件故障。
4. 版本降级测试：临时将react-native-webrtc降级到Expo 53时的版本，确认是否为WebRTC与Expo 55的兼容性问题。
5. 开启WebRTC详细日志：在原生代码中添加RTCSetMinDebugLogLevel(RTCLogLevelVerbose);，查看音频解码、输出环节的错误日志。

修复方案 #

1. 强制配置音频会话：创建RTCPeerConnection前，通过react-native-incall-manager显式初始化音频会话：

   import InCallManager from 'react-native-incall-manager';
   
   // 初始化音频会话为语音模式
   InCallManager.start({ media: 'audio' });
   InCallManager.setAudioMode('voice');
   

2. 延迟激活会话：在ontrack回调中确认音频轨道活跃后，延迟调用RTCAudioSession激活：

   pc.ontrack = (event) => {
     if (event.track.kind === 'audio' && event.track.readyState === 'live') {
       setTimeout(() => {
         RTCAudioSession.audioSessionDidActivate();
       }, 500);
     }
   };
   

3. 完善Expo权限配置：确保app.json中正确配置音频权限与后台模式：

   {
     "ios": {
       "infoPlist": {
         "NSMicrophoneUsageDescription": "需要访问麦克风进行语音通话",
         "UIBackgroundModes": ["audio"]
       }
     }
   }
   

4. 替换音频管理库：若react-native-incall-manager与Expo 55不兼容，尝试使用react-native-audio-session手动管理AVAudioSession。

三、为何仅Expo 53→55升级后iOS物理设备出现问题 #

Expo SDK 55基于React Native 0.83，相比SDK 53（React Native 0.82）的核心变化导致问题仅出现在物理设备：

• WebRTC底层版本升级：Expo 55更新了内置WebRTC库，新版本的RTCAudioSession逻辑与旧版Expo音频管理存在冲突，物理设备对会话状态的敏感度远高于模拟器。
• 权限逻辑变更：Expo 55修改了权限请求流程，WebRTC无法正确获取硬件访问权限，物理设备需要严格的权限校验，模拟器则绕过部分检查。
• 原生模块架构变化：React Native 0.83的原生模块架构调整，导致react-native-webrtc或react-native-incall-manager的音频会话管理逻辑失效，仅在物理设备上暴露问题。

内容的提问来源于stack exchange，提问作者Kartic Joshi