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