WebStorm运行WebRTC报错因HTTP协议被浏览器禁止调用getUserMedia，解决需启用HTTPS（如Live Server插件或npx serve）、配置有效STUN服务器、确保信令服务正常及手机端兼容性。
WebStorm 里直接跑 WebRTC 页面会报 getUserMedia 权限错误
浏览器在 http://localhost（非 HTTPS）下默认禁止调用 navigator.mediaDevices.getUserMedia，这是硬性安全策略，不是 WebStorm 配置问题。你点运行按钮后页面白屏、控制台报 NotAllowedError: Permission denied 或根本没弹权限框，基本都卡在这。
解决办法只有两个方向：
- 用 WebStorm 自带的「Live Server」插件启动，它默认启用 HTTPS（实际是自签名证书 + 本地代理），但需手动启用：Settings → Plugins → 搜索并安装
Live Server，然后右键 HTML 文件 →Open with Live Server - 改用本地 HTTPS 服务：在项目根目录执行
npx serve -s -l 8080（需提前npm install -g serve），再访问https://localhost:8080；注意首次访问 Chrome 会警告证书无效，点「高级」→「继续前往 localhost（不安全）」 - 开发阶段临时绕过（仅限 Chromium 内核）：启动 Chrome 时加参数
--unsafely-treat-insecure-origin-as-secure="http://localhost:63342" --user-data-dir=/tmp/chrome-test，其中端口 63342 是 WebStorm 默认内置服务器端口，但该方式不稳定，容易失效
WebSocket 信令服务无法连接到 localhost:8080
WebRTC 的信令通道（比如 new WebSocket('ws://localhost:8080')）连不上，常见于后端服务没真正在跑，或端口被占、跨域拦截、防火墙挡 UDP/HTTP 流量。WebStorm 本身不提供 WebSocket 服务，它只是前端编辑器。
你需要额外起一个信令服务：
- 最轻量：用 Node.js +
ws库写个 10 行信令中转服务，保存为signaling.js，然后终端执行node signaling.js；确保代码里监听的是0.0.0.0:8080而非127.0.0.1:8080，否则手机局域网访问不到 - 别用
localhost写死前端地址：JS 里 WebSocket 地址应写成ws://${location.hostname}:8080，这样 PC 和手机访问同一局域网 IP 时能自动适配 - 检查 Ubuntu/macOS 防火墙是否放行 TCP 8080 端口；Windows 用户注意关闭「Windows Defender 防火墙」的入站规则拦截
RTCPeerConnection 创建后一直 pending，ICE 连接失败
peerConnection.oniceconnectionstatechange 一直卡在 checking 或变成 failed，说明 STUN/TURN 协商失败。这不是 WebStorm 的锅，而是网络配置缺失。
必须显式配置可用的 STUN 服务器，且不能只写一个：
- 至少配两个公开 STUN：
{ urls: 'stun:stun.l.google.com:19302' }和{ urls: 'stun:stun1.l.google.com:19302' }；单个失效会导致整个 ICE 失败 - 局域网测试可简化：把
iceTransportPolicy设为"relay"强制走 TURN（但你得自己搭 coturn 服务），或者更实际一点——先设为"all"，确认基础通路再优化 - Chrome 地址栏输入
chrome://webrtc-internals，看「PeerConnections」面板里每个 candidate 的类型：如果全是host且状态为failed，大概率是 NAT 类型太严格，需要补充 TURN
手机和 PC 在同一 WiFi 下仍无法互通视频
PC 上能看到自己画面，手机也进房间了，但双方都黑屏、无远端流，常见原因是信令消息没真正双向送达，或 SDP 格式被意外篡改。
重点排查这几处：
- WebSocket 发送前不要 JSON.stringify 两次：
ws.send(JSON.stringify(offer))是对的，ws.send(JSON.stringify(JSON.stringify(offer)))就会让接收方 parse 出错，setRemoteDescription直接静默失败 - 手机浏览器必须用 Chrome 或 Edge（Safari 对 WebRTC 支持残缺，iOS 16.4+ 才支持
getDisplayMedia，但基础音视频通话仍受限） - Android 手机要关掉「省电模式」和「应用后台限制」，否则 WebSocket 连接会在切后台时被系统 kill，导致信令中断
- 检查
remoteVideo.srcObject = stream是否在ontrack回调里赋值；如果用onaddstream（已废弃），在新版 Chrome 中完全不会触发
WebStorm 只负责写和跑前端 HTML/JS，真正的音视频通路是否打通，取决于你填的 STUN 地址对不对、信令有没有丢包、手机系统有没有偷偷杀进程——这些环节任何一个出问题，都会让「本地测试」停在黑屏那一步。
