Flutter iOS应用使用flutter_inappwebview退后台后麦克风失效问题

开发者阿泽

2026-9-29

问题产生原因

iOS WebKit内核的独立管控逻辑：flutter_inappwebview在iOS端底层依赖WKWebView实现，苹果对WKWebView内部的媒体采集线程做了单独的后台限制，即使App层面配置了音频后台模式，WebView内的音视频采集回调也会在应用退后台时被默认暂停，该限制不跟随App的全局后台权限生效。
低版本flutter_inappwebview的适配缺失：你使用的5.3.2版本没有针对WebRTC后台采集场景做适配，既没有主动开启WebKit的后台媒体采集开关，也没有对AVAudioSession的活跃状态做持保处理。
音频会话配置不完整：仅配置Info.plist的后台audio模式不足以维持麦克风采集权限，未正确设置AVAudioSession的类别和活跃属性时，系统会在应用退后台后回收麦克风采集权限分配给前台应用。

排查步骤

复现问题时将设备连接Xcode，查看设备系统日志，搜索WKWebView、AVCaptureSession、MediaStream相关关键词，确认是否存在Media capture suspended because app is in background这类明确的暂停采集日志。
在应用退到后台时打印当前AVAudioSession的类别、活跃状态，确认是否出现会话被自动置为非活跃的情况。
用原生iOS项目直接用WKWebView加载相同的WebRTC页面测试，如果同样出现后台麦克风失效问题，即可排除Flutter层封装导致的问题。

解决方法

优先升级flutter_inappwebview到6.0.0及以上版本，该版本官方已经适配了WebRTC后台采集场景，新增了allowsBackgroundMediaPlayback等相关配置项，开启后即可支持后台麦克风采集。
如果你无法升级依赖版本，需要手动修改iOS端的WebView初始化配置，在创建WKWebView时添加以下参数：

WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
config.allowsInlineMediaPlayback = YES;
config.allowsAirPlayForMediaPlayback = YES;
config.allowsPictureInPictureMediaPlayback = YES;
// iOS15及以上系统开启后台媒体播放权限
if (@available(iOS 15.0, *)) {
    config.allowsBackgroundMediaPlayback = YES;
}
// 取消媒体播放的用户交互要求
config.mediaTypesRequiringUserActionForPlayback = WKAudiovisualMediaTypeNone;

全局配置AVAudioSession参数，在App启动、应用切前台/切后台时都主动设置音频会话属性，保持会话活跃：

AVAudioSession *session = [AVAudioSession sharedInstance];
NSError *error = nil;
[session setCategory:AVAudioSessionCategoryPlayAndRecord
         withOptions:AVAudioSessionCategoryOptionMixWithOthers |
                     AVAudioSessionCategoryOptionAllowBluetooth |
                     AVAudioSessionCategoryOptionDuckOthers
               error:&error];
[session setActive:YES error:&error];

若上述配置后仍存在问题，可以在应用退后台时启动一个静默音频循环播放任务，持续持有音频会话的活跃状态，避免系统回收麦克风权限。
最后检查Info.plist中是否已经正确添加NSMicrophoneUsageDescription权限描述，确认用户已经授予麦克风权限且没有手动禁用。

内容的提问来源于stack exchange，提问作者Victor Tortolero