pion/webrtc 单独跑不起来是因为它仅是 WebRTC 协议栈的 Go 客户端实现，无信令、无房间管理、不处理 NAT 穿透协调，也不自动转发 ICE candidate。
为什么 pion/webrtc 单独跑不起来？
因为 pion/webrtc 不是服务端框架，它只是 WebRTC 协议栈的 Go 语言客户端实现——没有信令、没有房间管理、不处理 NAT 穿透协调，更不会自动转发 ICE candidate。你写个 main.go 启动一个 *webrtc.PeerConnection，浏览器连不上不是代码写错了，是根本没地方“打招呼”。
常见错误现象：
-
peerConnection.OnICECandidate一直不触发（信令通道没通，candidate 出不去） - 浏览器控制台报
ICE connection state is failed（STUN/TURN 没配，或配置没生效） -
OnTrack回调完全不进（offer 中的 codec 浏览器选了 H.264，但服务端MediaEngine只注册了 VP8）
怎么配通第一个连接？三步不能少
必须手动补全信令链路和基础网络能力，缺一不可：
- 用
gorilla/websocket或gobwas/ws实现 WebSocket 信令通道，中转offer/answer/ice-candidate - 显式配置 STUN（比如
stun:stun.l.google.com:19302），否则本地局域网都可能连不通；公网部署必须加 TURN（turn:xxx），否则跨运营商基本失败 - 收到浏览器
offer后，严格按顺序调用：pc.SetRemoteDescription(offer)→pc.CreateAnswer()→pc.SetLocalDescription(answer)，漏一步，连接就卡死在checking
多个浏览器连进来，怎么不串流、不崩端口？
每个 WebSocket 连接必须绑定唯一一个 *webrtc.PeerConnection 实例，且生命周期完全一致——断开连接时必须调用 pc.Close()，否则 UDP 端口不释放，下次启动直接报 address already in use。
立即学习“go语言免费学习笔记（深入）”；
关键约束：
- 别复用
*webrtc.Configuration里的SettingEngine或MediaEngine到多个pc——它们不是线程安全的共享对象 - 每个
pc的OnICECandidate回调里，只把 candidate 推给对应客户端，不能广播 - 浏览器发来的
offer带多个 video codec（如 VP8/H.264/AV1），服务端初始化MediaEngine时得手动注册全：m.RegisterCodec(webrtc.RTPCodecCapability{MimeType: "video/h264", ...}, webrtc.RTPCodecTypeVideo)
OnTrack 为什么收不到流？先查这三件事
这不是“没连上”，而是 SDP 协商静默失败。最常被忽略的是编解码器对不上：
- 检查浏览器实际用的 codec：打开 Chrome 的
chrome://webrtc-internals，看getStats()里outbound-rtp的codec字段 - 确认服务端
MediaEngine注册了该 codec，且RTCPeerConnection创建时没禁用（例如企业版 Chrome 可能策略强制 H.264，而你的 pion 没注册） - 确认浏览器没用
RTCPeerConnection({sdpSemantics: 'unified-plan'})但服务端用的是 legacy plan（pion/v3 默认 unified，没问题；但老版本或自定义配置可能错）
真正麻烦的从来不是写几行 pc.AddTrack，而是让两端在毫秒级协商里，对上 codec、时钟源、rtpmap、rtcp-fb 这一堆参数。一旦出问题，没有日志，只有黑盒状态。
