浏览器与Node.js间WebRTC P2P问题：onaddstream事件未触发

先给你吃个定心丸：你这套「浏览器+Node.js服务端WebRTC连接+Socket.io信令+服务端录制流」的方案完全可行，不管用wrtc还是rtc-everywhere（它本质是对不同WebRTC实现的封装，适配Node.js这类非浏览器环境）都能达成目标，不少成熟的媒体录制服务都是类似架构，所以不用怀疑方向问题。

接下来针对你遇到的「Offer和ICE Candidate交换完成，但服务端onaddstream始终不触发」的问题，按优先级给你列几个排查点：

1. 先检查事件监听的时机是不是错了 #

onaddstream（或者新版的ontrack）必须在创建PeerConnection之后、设置远端SDP之前就绑定，不然事件触发的时候你的监听器还没挂上，自然收不到通知。举个正确的顺序例子：

// 服务端代码示例
const pc = new RTCPeerConnection(yourConfig);

// 先绑定事件！先绑定事件！先绑定事件！
pc.onaddstream = (event) => {
  console.log("终于收到远端流啦！", event.stream);
  // 这里就可以启动你的录制逻辑了
};

// 再去设置远端Offer
await pc.setRemoteDescription(new RTCSessionDescription(receivedOffer));

另外提一句：onaddstream是比较旧的API，新版WebRTC标准更推荐用ontrack事件，部分WebRTC实现对旧API的支持可能有小差异，你可以替换试试：

pc.ontrack = (event) => {
  const stream = event.streams[0];
  console.log("收到媒体轨道流", stream);
};

2. 确认ICE Candidate是不是真的交换完整了 #

虽然你说完成了交换，但还是要仔细核对：

• 服务端有没有正确把收到的所有ICE Candidate添加到PeerConnection里？别漏了异常捕获，不然加错了你也不知道：

// 服务端处理客户端发来的ICE Candidate
socket.on('ice-candidate', async (candidate) => {
  try {
    await pc.addIceCandidate(new RTCIceCandidate(candidate));
    console.log("成功添加ICE Candidate");
  } catch (e) {
    console.error("添加ICE Candidate失败，坑在这里！", e);
  }
});

• 两端都打日志，看看客户端发的Candidate数量和服务端收到的是不是一致，有没有因为Socket.io的消息丢失导致Candidate不全的情况。

3. 检查客户端有没有真的把媒体流挂到PeerConnection上 #

如果客户端只是创建了Offer，但没把本地的音视频轨道添加到PeerConnection里，服务端根本收不到流，自然不会触发onaddstream。客户端这边要确保有类似这样的代码：

// 客户端代码示例：获取本地媒体流并添加到PC
const stream = await navigator.mediaDevices.getUserMedia({ video: true, audio: true });
// 把所有轨道都加到PeerConnection里
stream.getTracks().forEach(track => pc.addTrack(track, stream));

// 然后再创建Offer、发送给服务端
const offer = await pc.createOffer();
await pc.setLocalDescription(offer);
socket.emit('offer', offer);

4. 排查rtc-everywhere的初始化问题 #

如果你用的是rtc-everywhere，要确认它是不是正确加载了Node.js环境下的WebRTC实现（也就是wrtc）。可以打个日志看看：

const { RTCPeerConnection } = require('rtc-everywhere');
console.log("当前使用的RTCPeerConnection实现：", RTCPeerConnection);

如果输出异常或者是空，可能是依赖安装出问题了，试试重新安装：

npm uninstall rtc-everywhere wrtc && npm install rtc-everywhere wrtc

5. 看看PeerConnection的状态变化，找蛛丝马迹 #

在服务端监听这两个状态变化事件，能帮你判断连接是不是真的建立起来了：

pc.oniceconnectionstatechange = () => {
  console.log("ICE连接状态更新：", pc.iceConnectionState);
};
pc.onsignalingstatechange = () => {
  console.log("信令状态更新：", pc.signalingState);
};

如果ICE连接状态一直停在connecting，或者变成failed，那肯定是ICE交换有问题，得接着查Candidate的有效性或者网络连通性。

最后给你个服务端录制流的小建议 #

等你成功收到流之后，可以用fluent-ffmpeg（封装了ffmpeg的Node.js库）来实现录制，比如把收到的WebRTC流转成MP4文件：

const ffmpeg = require('fluent-ffmpeg');
const { createWriteStream } = require('fs');

pc.ontrack = (event) => {
  const stream = event.streams[0];
  // 把WebRTC流通过管道传给ffmpeg保存
  ffmpeg()
    .input(stream)
    .inputFormat('webm') // WebRTC默认用webm格式传输
    .output('recording.mp4')
    .on('end', () => console.log("录制完成啦！"))
    .on('error', (err) => console.error("录制出错了：", err))
    .run();
};

内容的提问来源于stack exchange，提问作者Andrei Terecoasa