因为pion/webrtc仅为客户端级协议实现，不内置信令服务器、NAT穿透协调、房间管理及媒体流路由能力；必须自行实现WebSocket信令通道、显式配置STUN/TURN、隔离PeerConnection实例、注册编解码器并开放UDP端口。
WebRTC 服务端为什么不能只靠 webrtc-go 自己跑通？
因为 WebRTC 是点对点协议，服务端不转发音视频帧，只负责信令交换和 NAT 穿透辅助（如 STUN/TURN）。你用 github.com/pion/webrtc/v3 启动一个纯 PeerConnection 实例，它根本不会“流媒体”——没信令协调、没 SDP 协商入口、没 ICE 候选收集触发点，连客户端都连不上。
真正可交付的微服务必须包含三块：信令通道（WebSocket）、ICE 候选管理、以及可被外部调用的生命周期控制接口。常见错误是直接在 HTTP handler 里 new PeerConnection，结果每个请求生成孤立连接，SDP 无法匹配，onTrack 永远不触发。
- 信令必须复用同一 WebSocket 连接，且需按顺序处理
offer/answer/candidate消息 -
PeerConnection实例不能绑定到 HTTP 请求生命周期，得存在 map 或 sync.Map 中，key 为会话 ID - STUN 地址必须显式配置（如
stun:stun.l.google.com:19302），否则本地测试看似正常，一上公网就卡在 ICE 连接失败
如何让 PeerConnection 支持多路复用与状态隔离？
一个 PeerConnection 只能对应一个远程 peer，但微服务要支撑成百上千并发会话。硬开 goroutine + map 存 *webrtc.PeerConnection 不行——连接断开时资源不释放，OnICEConnectionStateChange 回调里没做清理，内存持续增长。
正确做法是把连接生命周期和会话 ID 绑定，并配超时自动关闭：
立即学习“go语言免费学习笔记（深入）”；
type Session struct {
ID string
PC *webrtc.PeerConnection
CreatedAt time.Time
LastActive time.Time // 更新于每次收到 candidate 或 track
}
<p>var sessions = sync.Map{} // key: sessionID, value: *Session</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/gongju/2525" title="Go语言（Golang）1.26.0"><img
src="https://img.php.cn/upload/manual/001/589/237/6a6adeed24a4a355.png" alt="Go语言（Golang）1.26.0" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/gongju/2525" title="Go语言（Golang）1.26.0">Go语言（Golang）1.26.0</a>
<p>Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。</p>
</div>
<a href="/xiazai/gongju/2525" title="Go语言（Golang）1.26.0" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>// 超时检查 goroutine（每 30s 扫描）
go func() {
for range time.Tick(30 <em> time.Second) {
sessions.Range(func(key, value interface{}) bool {
s := value.(</em>Session)
if time.Since(s.LastActive) > 5*time.Minute {
s.PC.Close()
sessions.Delete(key)
}
return true
})
}
}()- 不要用全局
*webrtc.PeerConnection，每个会话独占实例 - 所有
OnXXX回调（尤其是OnTrack）里必须加defer或显式 close track，否则音频解码器线程泄漏 - 如果需要转发流（如混流或录制），必须用
WriteSample写入新Track，不能直接复制MediaStreamTrack对象
为什么 WebSocket 信令里 candidate 字段总为空？
这是最常踩的坑：PeerConnection 默认不自动收集 ICE 候选，必须手动调用 pc.OnICECandidate 并触发 pc.SetLocalDescription 后才会开始收集。很多示例漏掉这一步，导致客户端收不到 candidate，ICE 状态卡在 checking。
关键顺序不能错：
- 先
pc.SetLocalDescription(desc)（desc 来自自己生成的 offer/answer） - 再注册
pc.OnICECandidate回调，在回调里通过 WebSocket 发送candidate字符串 - 客户端发来的
candidate必须用pc.AddICECandidate注入，且要在pc.RemoteDescription()已设置的前提下
典型错误日志：failed to add ICE candidate: no remote description —— 就是 RemoteDescription 还没 set，你就急着 add candidate。
如何安全暴露音视频流给外部系统（如 FFmpeg 或 OBS）？
WebRTC 流本质是 SRTP 加密的 RTP 包，FFmpeg 默认不支持直接拉。想对接传统工具，必须做协议转换：要么用 pion/ion-sfu 这类 SFU 做转封装，要么在服务端用 gortsplib 推 RTSP 流。
更轻量的做法是用 webrtc-go 的 Track 输出原始 PCM/H.264 数据，再喂给编码器：
track.OnTrack(func(t *webrtc.TrackRemote, receiver *webrtc.RTPReceiver) {
for {
pkt, _, err := t.ReadRTP()
if err != nil {
break
}
// 这里可以写入 h264 Annex-B 格式 buffer，供 FFmpeg -f h264 stdin 拉流
// 注意：H.264 需提取 SPS/PPS，PCM 需补 WAV 头或转 AAC
}
})- 不要尝试把
Track直接塞进os.Stdout——没有帧边界标记，FFmpeg 会解析失败 - 音频若为 Opus，需用
github.com/pion/webrtc/v3/pkg/media/opus解码后再转 PCM，否则 FFmpeg 无法识别 - 生产环境务必限制单个会话带宽（
pc.SetConfiguration中设ICEServers和RTCPMuxPolicy），否则公网用户可能打满服务器网卡
WebRTC 微服务最难的不是连接建立，而是状态同步精度和资源回收时机——比如一个 OnTrack 回调刚启动解码 goroutine，客户端突然断开，而 OnConnectionStateChange 还没来得及触发，那这个 goroutine 就永远卡住。所有异步操作必须绑定 context，并在 pc.OnConnectionStateChange 切到 webrtc.PeerConnectionStateFailed 或 Closed 时 cancel。
