Mac端WebRTC报错：RTCIceServer.urls必填且需为DOMString或sequence类型

算力阿峰

2026-6-21

解决RTCIceServer成员异常问题（Mac WebRTC场景）

问题核心

Mac环境下WebRTC对RTCIceServer的校验更严格：urls字段为必填项，且必须是DOMString字符串或DOMString数组（sequence类型），不符合要求会直接触发异常，导致ICE连接失败，无法建立通话。

修复方案

1. 修正ICE服务器配置格式

确保RTCIceServer配置正确包含urls字段，格式符合标准：

单个服务器配置（字符串类型）：

const iceServers = [
  {
    urls: 'stun:stun.l.google.com:19302',
    // 需身份验证时添加以下字段
    // username: 'your-username',
    // credential: 'your-credential'
  }
];

多个服务器配置（数组类型）：

const iceServers = [
  {
    urls: [
      'stun:stun.l.google.com:19302',
      'stun:stun1.l.google.com:19302'
    ]
  }
];

2. 废弃字段排查

不要使用旧版的url（单数）字段，WebRTC标准已废弃该字段，Mac端浏览器会严格校验，必须使用urls（复数）。

3. 配置预校验（可选）

创建RTCPeerConnection前可先校验配置有效性，提前拦截错误：

function checkIceServerValidity(iceServers) {
  return iceServers.every(server => {
    if (!server.urls) return false;
    const isValidString = typeof server.urls === 'string';
    const isValidArray = Array.isArray(server.urls) && server.urls.every(item => typeof item === 'string');
    return isValidString || isValidArray;
  });
}

// 使用示例
const iceServers = [/* 你的配置 */];
if (!checkIceServerValidity(iceServers)) {
  console.error('ICE服务器配置格式错误');
} else {
  const peerConn = new RTCPeerConnection({ iceServers });
  // 执行后续通话逻辑
}