Ionic在iOS平台重写user-agent导致WebRTC兼容性问题求解

核心原因：Ionic iOS端依赖的WebView插件（Cordova/Capacitor官方WebView插件）默认硬编码了匹配iOS 13.3.2/Safari 13.0.3的固定User-Agent，不会跟随设备实际系统版本更新，即便用户运行在iOS 14+系统上，WebRTC平台读取到的UA标识依然是Safari 13版本，直接触发版本拦截。 #

方案1：配置文件直接覆盖UA（最快生效，推荐） #

根据你用的技术栈选对应的配置方式即可，配置后重新编译包就能生效。

Cordova栈 #

打开项目根目录的config.xml，在iOS平台配置块中添加覆盖规则，直接把UA里的Safari版本号替换为14以上即可，注意保留WebView核心特征字段，不要随意改成其他浏览器UA避免触发兼容问题：

<platform name="ios">
  <!-- 保留原有iOS配置项 -->
  <preference name="OverrideUserAgent" value="Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.0 Mobile/15E148 Safari/604.1" />
</platform>

如果不想完全替换UA，也可以用AppendUserAgent参数追加自定义字段，但注意原有固定UA里的版本标识不会被自动替换，必须用OverrideUserAgent才能覆盖旧版本号。

Capacitor栈 #

打开项目根目录的capacitor.config.ts/capacitor.config.json，在iOS配置块中添加UA覆盖规则：

const config: CapacitorConfig = {
  // 保留原有基础配置
  ios: {
    // 自定义UA，版本号可根据你最低支持的iOS版本调整，只要Safari版本≥14即可
    overrideUserAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.0 Mobile/15E148 Safari/604.1'
  }
};

配置完成后执行npx cap sync ios同步原生配置，重新打包即可。 #

方案2：动态读取设备真实UA（长期维护推荐） #

如果不想写死UA版本，避免后续系统升级后UA再次落后，可以在App启动时动态获取当前WKWebView的真实UA，覆盖插件默认的固定值。

Capacitor原生修改 #

打开iOS原生工程下的ios/App/App/ViewController.swift，在viewDidLoad生命周期中添加如下代码：

override func viewDidLoad() {
  super.viewDidLoad()
  // 异步获取WebView真实UA
  webView?.evaluateJavaScript("navigator.userAgent") { [weak self] ua, err in
    guard let validUA = ua as? String, err == nil else { return }
    // 覆盖插件默认的固定UA
    self?.webView?.customUserAgent = validUA
  }
}

Cordova插件实现 #

直接安装cordova-plugin-useragent插件，在deviceready事件触发后重置UA为真实值：

document.addEventListener('deviceready', () => {
  UserAgent.get(realUA => {
    UserAgent.set(realUA, () => console.log('UA重置完成'))
  })
}, false)

验证步骤 #

把编译后的安装包装到iOS 14+测试机上，打开调试面板执行navigator.userAgent，确认输出字段里的Version/后面的版本号≥14.0，再调用WebRTC接口就不会触发低版本拦截。

注意：不要把UA修改为Chrome、Firefox等其他移动端浏览器标识，iOS端所有第三方浏览器内核都是基于WKWebView，修改UA为其他浏览器会导致部分WebRTC原生API被禁用，反而引发功能异常。

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