gorilla/websocket 仅可用于 webrtc 信令传输，不能替代 webrtc 协议栈；webrtc 音视频传输必须用 pion/webrtc/v3 等专用库实现底层 udp、dtls、rtp 等功能。
gorilla/websocket 不能用于 WebRTC 通信——它只管文本/二进制消息的双向通道，而 WebRTC 是一套完整的实时音视频传输协议栈，底层依赖 UDP、ICE、STUN/TURN、DTLS、SCTP 等，必须用专用库。
Golang 实现 WebRTC 服务端，唯一成熟选择是 pion/webrtc/v3（截至 2026 年 4 月仍是事实标准）；它不封装信令，也不处理媒体编解码，但提供了完整、可组合的底层 API。
为什么不能用 net/http 或 gorilla/websocket 做 WebRTC 信令通道？
WebRTC 自身不定义信令协议，但要求你用其他通道（比如 HTTP 或 WebSocket）交换 SDP 和 ICE candidate。这里容易混淆：websocket 可以做信令传输管道，但它和 WebRTC 数据通路完全无关。
- 信令只是“约架”：交换
offer/answer和ice-candidate字符串，不传音视频帧 -
pion/webrtc的*PeerConnection对象自己管理 UDP socket、DTLS 握手、RTP/RTCP 流、NAT 打洞——这些和http.ResponseWriter没半点关系 - 若误把
conn.WriteMessage()当作发送视频帧，会直接 panic：类型不匹配、帧格式错误、无时间戳、无 SSRC，浏览器根本不会解码
如何用 pion/webrtc/v3 建立一个最简 peer 连接？
关键不是“写个 handler”，而是初始化 *webrtc.PeerConnection 并监听事件。以下是最小可行骨架：
func newPeerConnection() (*webrtc.PeerConnection, error) {
config := webrtc.Configuration{
ICEServers: []webrtc.ICEServer{
{URLs: []string{"stun:stun.l.google.com:19302"}},
},
}
return webrtc.NewPeerConnection(config)
}
pc, err := newPeerConnection()
if err != nil {
log.Fatal(err)
}
defer pc.Close()
// 必须设置 onTrack，否则收不到远端视频流
pc.OnTrack(func(track *webrtc.TrackRemote, receiver *webrtc.RTPReceiver) {
log.Printf("收到 track: %s, codec: %s", track.Label(), track.Codec().MimeType)
// 此处可将 track.Read() 的 RTP 包转发给转码器、录制器或转发到其他 peer
})
// 必须设置 onICECandidate，否则无法完成 NAT 穿透
pc.OnICECandidate(func(c *webrtc.ICECandidate) {
if c == nil {
return
}
// 把 c.ToJSON() 发给对端（通过你自己的信令通道，比如 WebSocket）
sendSignalingMessage(c.ToJSON())
})
-
OnTrack是接收媒体流的唯一入口，track.Read()返回原始 RTP 包，不是[]byte媒体数据 -
OnICECandidate触发多次，每次都要发给对端；漏掉任意一个，连接大概率失败（尤其在双 NAT 后） - 不要手动调用
pc.AddTrack()后立刻pc.SetLocalDescription()：必须等pc.OnICEGatheringStateChange变为webrtc.ICEGathererStateComplete再发 offer，否则 candidate 不全
信令通道怎么和 pion/webrtc 配合？
信令本身无协议约束，但字段必须严格对应浏览器 WebRTC API。常见错误是 JSON 键名大小写或嵌套层级错位：
- 浏览器调
peerConnection.setRemoteDescription({type:'offer', sdp:'v=0...'})→ 服务端必须解析出type和sdp字段，传给pc.SetRemoteDescription(webrtc.SessionDescription{Type:webrtc.SDPTypeOffer, SDP:sdp}) - 浏览器发
ice-candidate是对象：{candidate:"...", sdpMid:"0", sdpMLineIndex:0}→ 服务端需用webrtc.UnmarshalICECandidate()解析，再喂给pc.AddICECandidate() - 若用
gorilla/websocket传信令，记得设upgrader.CheckOrigin白名单，且子协议（Subprotocols）要和前端new WebSocket(url, ['json'])一致，否则连接静默关闭
为什么本地测试连不通？重点检查这三处
90% 的“连不上”问题出在基础配置，和业务逻辑无关：
- NAT 类型：纯内网（如公司防火墙后）必须配
TURN服务器，STUN单独不够；pion/webrtc不自带 TURN，得额外跑coTURN或用云服务 - ICE 超时：默认
ICETimeout是 30 秒，若候选收集慢或网络延迟高，连接会卡在checking状态；可调大Configuration.ICETransportPolicy = webrtc.ICETransportPolicyAll并加日志看OnICEConnectionStateChange - 证书与 DTLS：浏览器强制要求 DTLS 证书，
pion/webrtc默认自签；若用自定义SettingEngine，必须确保se.SetDTLSEncryptionKey(...)或让库自动生成，否则握手失败无明确报错
OnICEConnectionStateChange 和 OnConnectionStateChange 日志，而不是一上来就改媒体处理逻辑。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
