# 如何处理常见的 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)。
## 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` 方法。
## 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)。
## 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 调用顺序。