# 如何处理常见的 Web 浏览器控制台报错？ (/zh-CN/reference/faq/integration/console_error_web)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

将 Web SDK 集成到你的 Web 应用后，遇到问题时可以通过浏览器控制台打印的日志进行调试。

本文列出控制台日志中常见的错误和原因。

## Cannot read property "appendChild" of null [#cannot-read-property-appendchild-of-null]

### 错误原因 [#错误原因]

播放指定的 DOM 不存在或者 ID 没有找到。

### 解决办法 [#解决办法]

确保在调用 `Stream.play` 方法时已生成相应的父容器。

## Cannot read property 'stringuid' of undefined [#cannot-read-property-stringuid-of-undefined]

### 错误原因 [#错误原因-1]

在还未成功加入频道时调用了 `Client.publish` 方法。

### 解决办法 [#解决办法-1]

检查你的集成逻辑，确保在调用 `Client.publish` 时已成功加入频道。

## Connect choose server timeout [#connect-choose-server-timeout]

错误原因和解决方法同 [Failed to load resource](#resource)。

<a id="DTLS"></a>
## DTLS failed [#dtls-failed]

下表列出了常见的错误原因和相应的解决办法。

| 错误原因                                                     | 解决办法                                                     |
| :----------------------------------------------------------- | :----------------------------------------------------------- |
| 使用的浏览器不完全支持 WebRTC。                              | 使用 Web SDK [支持的浏览器](/zh-CN/realtime-media/rtc/reference/browser-compatibility)。 |
| 使用了某些浏览器插件，导致 WebRTC 无法获取本地 Candidate。   | 关闭浏览器插件。                                             |
| 用户的网关防火墙禁用了 UDP 协议或者禁用了 10000 以上的 UDP 端口。 | 关闭防火墙或者使用云代理服务。 |
| 用户使用了 VPN。                                             | 关闭 VPN。                                                   |
| 浏览器使用的编解码格式为 VP8，但用户使用的 Safari 浏览器不支持 VP8。 | 建议用户将 Safari 升级到 12.1 以上版本，或者使用 Chrome 浏览器。 |
| 浏览器使用的编解码格式为 H.264， 但设备硬件不支持 H.264。    | 将编解码格式设为 VP8。                                       |
| 网络运营商连接问题。                                         | 建议用户尝试更换网络，例如使用手机蜂窝数据连接。             |

如果按照以上方法排查后仍然报错，请联系声网技术支持。

## Failed to execute 'addStream' on 'RTCPeerConnection': parameter 1 is not of type 'MediaStream' [#failed-to-execute-addstream-on-rtcpeerconnection-parameter-1-is-not-of-type-mediastream]

### 错误原因 [#错误原因-2]

在 `Stream.init` 尚未成功时就调用了 `Client.publish` 。

### 解决办法 [#解决办法-2]

在 `Stream.init` 成功的回调中调用 `publish` 方法。

<a id="resource"></a>
## Failed to load resource [#failed-to-load-resource]
### 错误原因 [#错误原因-3]

用户本地的 DNS 解析错误。

### 解决办法 [#解决办法-3]

建议用户根据所在区域修改 DNS 服务器的地址后重新加入频道：

- 中国大陆用户将 DNS 服务器设为 `114.114.114.114`。
- 中国大陆之外的用户将 DNS 服务器设为 `8.8.8.8`。

## Failed to set remote answer sdp: Called in wrong state: kStable [#failed-to-set-remote-answer-sdp-called-in-wrong-state-kstable]

### 错误原因 [#错误原因-4]

调用 `switchDevice` 导致报错。

### 解决办法 [#解决办法-4]

该错误没有任何影响，忽略即可。

## Invalid elementID [#invalid-elementid]

### 错误原因 [#错误原因-5]

 `Stream.play` 中指定的 `HTMLElementID` 不合法。

### 解决办法 [#解决办法-5]

确保 `HTMLElementID` 字符串仅包含 ASCII 字符集中的字母和数字，或 "_"、"-"、"."，且字符串长度大于 0 小于 256 字节。

## INVALID_VENDOR_KEY [#invalid_vendor_key]

### 错误原因 [#错误原因-6]

可能的原因有：

- 使用的 App ID 无效。例如 App ID 对应的声网项目处于禁用状态，或者新建的声网项目 App ID 尚未生效。
- 使用的 token 无效。

### 解决办法 [#解决办法-6]

检查 `Client.init` 中 `appId` 和 `Client.join` 中 `tokenOrKey` 的设置，确保使用有效的 App ID 和 token。

## Media access MEDIA_NOT_SUPPORT: video/audio streams not supported yet /enumerateDevices() not supported [#media-access-media_not_support-videoaudio-streams-not-supported-yet-enumeratedevices-not-supported]

### 错误原因 [#错误原因-7]

可能的原因有：

- 使用的浏览器不兼容 Web SDK。
- 没有使用 HTTPS 协议或者 localhost 打开页面。

### 解决办法 [#解决办法-7]

- 使用 Web SDK [支持的浏览器](/zh-CN/realtime-media/rtc/reference/browser-compatibility)。
- 使用 HTTPS 协议或者 localhost 打开页面。

## NO_CANDIDATES_IN_OFFER [#no_candidates_in_offer]

错误原因和解决方法同 [None Ice Candidate not allowed](#candidate)。

<a id="candidate"></a>

<a id="none-ice-candidate-not-alloweda-namecandidatea"></a>

## None Ice Candidate not allowed [#none-ice-candidate-not-allowed]
### 错误原因 [#错误原因-8]

建立 WebRTC 连接时未找到 [ICE](https://developer.mozilla.org/zh-CN/docs/Glossary/ICE) (Interactive Connectivity Establishment) candidate。

:::info[信息]
Candidate 是指用于媒体传输的候选地址，包含 IP 地址和端口信息。
:::

### 解决办法 [#解决办法-8]

根据是否开启[云代理](/zh-CN/realtime-media/rtc/build/setup-and-access/firewall#云代理方案)，建立连接时会使用不同类型的 candidate，因此解决办法也不同。

- 如果你开启了云代理，SDK 会从 TURN Server 获取 relay candidate，所以你需要检查是否已经将声网指定的云代理 IP 地址和端口添加到白名单，并确保客户端可以正常连接到 TURN Server。
- 如果没有开启云代理功能，SDK 会从本地设备获取 host candidate。获取失败通常是由于安全策略设置导致的，你可以进行以下排查。
  - 检查浏览器是否安装了禁用 WebRTC 的插件。
  - 确保本地设备的防火墙设置未禁用 UDP，且已经将[指定的域名和端口](/zh-CN/realtime-media/rtc/build/setup-and-access/firewall)添加到白名单。

## P2P lost [#p2p-lost]

错误原因和解决方法同 [DTLS failed](#DTLS)。

## UID_CONFLICT [#uid_conflict]

### 错误原因 [#错误原因-9]

 一个频道中有多个相同的 `uid`。

### 解决办法 [#解决办法-9]

确保频道中每个用户的 `uid` 是唯一的。

## Uncaught DOMException: Failed to execute 'addTransceiver' on 'RTCPeerConnection': This operation is only supported in 'unified-plan'. [#uncaught-domexception-failed-to-execute-addtransceiver-on-rtcpeerconnection-this-operation-is-only-supported-in-unified-plan]

### 错误原因 [#错误原因-10]

在浏览器上开启了模拟移动设备调试。

### 解决办法 [#解决办法-10]

Web SDK 不支持模拟移动设备调试，请勿使用模拟器进行调试。

## Uncaught TypeError: Failed to execute 'createObjectURL' on 'URL': No function was found that matched the signature provided [#uncaught-typeerror-failed-to-execute-createobjecturl-on-url-no-function-was-found-that-matched-the-signature-provided]

### 错误原因 [#错误原因-11]

在浏览器上开启了模拟移动设备调试。

### 解决办法 [#解决办法-11]

Web SDK 不支持模拟移动设备调试，请勿使用模拟器进行调试。

## User is not in the session [#user-is-not-in-the-session]

### 错误原因 [#错误原因-12]

该错误表示尚未建立连接，通常是因为调用 API 时序不正确导致的。例如调用了 `Client.leave` 之后调用 `Client.publish`。

### 解决办法 [#解决办法-12]

检查你的 API 调用顺序。