Pion的PeerConnection仅实现单个端到端连接协议栈，不提供信令、房间管理或媒体路由；必须自行搭建WebSocket信令通道、显式配置STUN/TURN、隔离实例、注册编解码器，任一缺失均导致黑屏静音。
直接说结论：Pion webrtc.PeerConnection 本身不提供信令、房间管理或媒体路由能力，只负责单个端到端连接的协议栈实现；想跑通音视频流，必须自己搭 WebSocket 信令通道、显式配置 STUN/TURN、隔离每个连接的 PeerConnection 实例，并正确注册编解码器——漏掉任一环，浏览器就黑屏静音。
为什么 OnTrack 回调从不触发？
这是最常被卡住的点，现象是浏览器发了 addTrack，服务端日志却完全没进 pc.OnTrack。根本原因不是网络不通，而是 SDP 协商失败导致 track 被静默丢弃。
- 浏览器 offer 带了
H.264，但 Pion 默认只注册了VP8和Opus，协商时跳过该 track，不报错也不回调 -
MediaEngine必须在创建PeerConnection前手动注册所需 codec：m.RegisterCodec(webrtc.RTPCodecParameters{MimeType: "video/h264"}, webrtc.RTPCodecTypeVideo) - 检查浏览器生成的 offer SDP 中是否含
a=recvonly或a=inactive—— 某些前端库（如 simple-peer）默认设为只收，需显式改成a=sendrecv - 确保
pc.OnTrack在pc.SetRemoteDescription之前就已设置，否则早期 candidate 可能丢失
ICE candidate 死活不触发？
pc.OnICECandidate 不回调，通常意味着 ICE 收集根本没启动，而不是收集失败。
-
SettingEngine未启用 ICE 自动启动：需调用se.SetAutomaticGathering(false)后再se.SetNAT1To1IPs等，否则某些内网环境直接跳过收集 -
ICEServers配置为空或 URL 格式错误（比如写成stun://而非stun:），Pion 会静默忽略，不报错但 ICE 不工作 - UDP 端口被占用或防火墙拦截：
net.ListenUDP失败时 Pion 不 panic，只让 ICE 停摆；建议启动时加日志：log.Printf("listening on %v", addr) - 测试阶段可用 Google 公共 STUN：
[]webrtc.ICEServer{{URLs: []string{"stun:stun.l.google.com:19302"}}，但别用于生产
多个客户端连上来，音视频串流或崩溃？
Pion 的 PeerConnection 实例不是线程安全的共享对象，复用配置或回调会导致状态污染。
立即学习“go语言免费学习笔记（深入）”；
- 每个 WebSocket 连接必须绑定唯一
*webrtc.PeerConnection，不能全局复用一个实例 -
MediaEngine和SettingEngine也不能跨PeerConnection复用；每次 new 都要新建：m := &webrtc.MediaEngine{} -
OnICECandidate回调里必须把 candidate 推给对应客户端，不能广播；否则 A 的 candidate 被 B 收到，B 会尝试连 A 的私有 IP，必然失败 - 连接关闭时务必调用
pc.Close()，否则 UDP fd 不释放，下次NewPeerConnection可能报address already in use
真正麻烦的从来不是代码写几行，而是每个 PeerConnection 生命周期里，SetRemoteDescription、CreateAnswer、OnICECandidate、OnTrack 这四件事的时序和作用域必须严丝合缝——差一点，流就断在半路，还查不出错在哪。
