P2P 与分布式存储 / 系统课时
验证 DataChannel 双向消息
验证 DataChannel 双向消息
WebRTC 的 SDP 协商完成、ICE 连接成功,并不代表应用数据已经可以正常收发。本课使用两个浏览器页面验证 DataChannel 的双向消息传输,再通过 WebRTC 统计信息找到实际选中的 ICE 候选对,判断数据走的是直连路径还是 TURN 中继路径。
学习目标
- 正确等待 DataChannel 进入
open状态,并完成双向消息收发验证。 - 使用
getStats()定位选中的 ICE 候选对,识别host、srflx和relay类型。 - 区分应用层消息成功、ICE 连通性成功与实际传输路径,完成可重复的验收。
DataChannel 的 open 状态意味着什么
RTCDataChannel.readyState 有四种状态:connecting、open、closing 和 closed。只有进入 open,应用才应该开始发送正常业务消息。RTCPeerConnection.connectionState 为 connected 不能替代 DataChannel 的状态检查,因为两者描述的对象不同。
| 检查对象 | 通过条件 | 能证明什么 |
|---|---|---|
pc.connectionState |
connected |
PeerConnection 的传输连接已建立 |
channel.readyState |
open |
当前 DataChannel 可以发送数据 |
channel.onmessage |
收到预期消息 | 对端消息到达应用层 |
candidate-pair 统计 |
找到选中的候选对 | 能识别当前 ICE 传输路径 |
验证时应先监听 open、message、error 和 close 事件。若注册监听器时通道已经是 open,还应直接执行发送逻辑,避免错过已经触发的事件。
用两个浏览器页面完成双向收发
下面的最小示例使用同一浏览器的两个标签页,通过 BroadcastChannel 在本地交换 SDP 和 ICE 候选。它不需要单独部署信令服务器,适合验证 DataChannel 事件与双向收发。由于两个标签页运行在同一设备上,这个示例不能用于证明跨 NAT 穿透成功;真实网络路径应在跨设备测试中检查。
准备一个 index.html,在文件中写入以下完整代码。使用支持 WebRTC 的现代 Chromium 或 Firefox 浏览器,并通过本地 HTTP 服务访问。打开两个同源标签页,先在一个页面点击“发起连接”,另一个页面会自动应答。
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>DataChannel 双向验证</title>
<button id="start">发起连接</button>
<pre id="log"></pre>
<script>
const log = (...args) => {
document.querySelector('#log').textContent += args.join(' ') + '\n';
};
const signaling = new BroadcastChannel('webrtc-data-test');
const pc = new RTCPeerConnection();
let channel;
let pending = [];
let remoteReady = false;
function bindChannel(dc) {
channel = dc;
dc.addEventListener('open', () => {
log('DataChannel open');
if (dc.label === 'test') dc.send('PING:A');
});
dc.addEventListener('message', event => {
log('收到:', event.data);
if (event.data === 'PING:A') dc.send('PONG:B');
if (event.data === 'PONG:B') dc.send('ACK:A');
});
dc.addEventListener('error', event => log('通道错误:', event.type));
dc.addEventListener('close', () => log('DataChannel closed'));
}
pc.addEventListener('datachannel', event => bindChannel(event.channel));
pc.addEventListener('icecandidate', event => {
if (event.candidate) signaling.postMessage({candidate: event.candidate.toJSON()});
});
signaling.onmessage = async ({data}) => {
try {
if (data.description) {
if (data.description.type === 'offer') {
if (pc.signalingState !== 'stable') return;
await pc.setRemoteDescription(data.description);
remoteReady = true;
for (const candidate of pending.splice(0)) await pc.addIceCandidate(candidate);
await pc.setLocalDescription(await pc.createAnswer());
signaling.postMessage({description: pc.localDescription});
} else if (data.description.type === 'answer' && pc.signalingState === 'have-local-offer') {
await pc.setRemoteDescription(data.description);
remoteReady = true;
for (const candidate of pending.splice(0)) await pc.addIceCandidate(candidate);
}
} else if (data.candidate) {
if (remoteReady) await pc.addIceCandidate(data.candidate);
else pending.push(data.candidate);
}
} catch (error) {
log('信令处理失败:', error.message);
}
};
document.querySelector('#start').onclick = async () => {
if (pc.signalingState !== 'stable' || channel) return;
// 仅由发起端创建通道,接收端通过 datachannel 事件获取。
bindChannel(pc.createDataChannel('test'));
await pc.setLocalDescription(await pc.createOffer());
signaling.postMessage({description: pc.localDescription});
};
</script>
</html>启动本地服务:
python -m http.server 8000预期结果:终端显示 HTTP 服务已启动,监听端口为 8000;实际启动提示因 Python 版本而异。访问 http://localhost:8000/ 并打开第二个标签页。这里的端口是示例固定配置,修改命令时应同步修改访问地址。
发起端页面的预期输出:
DataChannel open
收到: PONG:B接收端页面的预期输出:
DataChannel open
收到: PING:A
收到: ACK:A这三条消息形成完整的应用层确认链:A 发送 PING:A,B 收到后回复 PONG:B,A 收到后发送 ACK:A,B 再次收到确认。两端均出现预期记录,才算通过本例的双向收发验收。
本示例要求两个标签页处于同一浏览器存储分区,并且只打开一个发起端和一个接收端。BroadcastChannel 只承担本地信令交换,不承载 DataChannel 的业务消息。实际项目应使用自己的 WebSocket 信令服务替换它,并通过会话 ID 将消息路由到正确的远端。
找到实际选中的 ICE 候选对
双向消息成功之后,需要回答第二个问题:这些消息究竟通过哪条网络路径传输?WebRTC 的 ICE 机制会检查候选地址组合,并选择可用的候选对。getStats() 可以读取当前连接的统计信息。
在已有 pc 变量的页面中执行以下片段。它依赖前面建立的 RTCPeerConnection,因此属于片段示例,应在 DataChannel 进入 open 后调用。
async function inspectSelectedPair(pc) {
const stats = await pc.getStats();
const transports = [...stats.values()].filter(s => s.type === 'transport');
const selectedIds = new Set(transports.map(s => s.selectedCandidatePairId).filter(Boolean));
const pair = [...stats.values()].find(s =>
s.type === 'candidate-pair' &&
(selectedIds.has(s.id) || (s.selected === true && s.state === 'succeeded'))
);
if (!pair) {
console.log('尚未找到选中的候选对');
return;
}
const local = stats.get(pair.localCandidateId);
const remote = stats.get(pair.remoteCandidateId);
console.table({
localType: local?.candidateType,
remoteType: remote?.candidateType,
state: pair.state,
bytesSent: pair.bytesSent,
bytesReceived: pair.bytesReceived
});
}
inspectSelectedPair(pc);预期结果:控制台显示一张表,包含本地候选类型、远端候选类型、候选对状态以及累计收发字节数。候选类型取决于实际网络,不能预先指定;部分浏览器可能不提供所需统计字段,此时会显示“尚未找到选中的候选对”。
| 候选类型 | 含义 | 路径判断 |
|---|---|---|
host |
本机网络接口候选,可能以 mDNS 名称表示 | 非 TURN 中继候选 |
srflx |
服务器反射候选,通常由 STUN 获得 | 非 TURN 中继候选 |
relay |
TURN 分配的中继候选 | 该端使用 TURN 中继 |
如果选中的本地候选或远端候选为 relay,说明选定路径包含 TURN 中继。两端都是 host 或 srflx 等非中继候选时,说明这条 ICE 候选路径未使用 TURN 中继,但不能仅凭候选类型证明它跨越了哪种 NAT,也不能证明路径经过公网。

验证消息确实经过选中路径
bytesSent 和 bytesReceived 是候选对统计对象中的累计字节数。可以在发送测试消息前后分别采样,检查计数是否增长,但需要注意 ICE 检查、保活以及其他协议流量也可能影响计数。因此,字节增长只能作为辅助证据,不能单独证明某一条应用消息已经送达。
建议按以下顺序完成真实网络验收:
- 在不同设备或不同网络的浏览器中建立 WebRTC 连接,使用实际信令服务器完成 Offer、Answer 和 ICE 候选交换。
- 等待两端 DataChannel 均为
open,发送带唯一消息 ID 的测试消息,并要求对端原样确认该 ID。 - 在发送前后分别调用
getStats(),记录选中候选对 ID、两端候选类型、候选对状态及字节计数。 - 使用浏览器的
chrome://webrtc-internals或 Firefox 的about:webrtc辅助检查连接状态和候选信息;具体字段展示随浏览器版本变化。 - 在提供有效 TURN 服务的前提下,将两端
RTCPeerConnection的iceTransportPolicy设置为relay,重新建立连接并重复测试,验证中继路径。
iceTransportPolicy: 'relay' 必须在创建连接时通过配置对象设置,或通过受支持的 setConfiguration() 更新后重新进行必要的 ICE 协商。不能仅修改应用变量就认为当前连接已经切换路径。
常见失败如何定位
| 现象 | 优先检查 | 修复方式 |
|---|---|---|
DataChannel 一直 connecting |
SDP 是否完整交换、ICE 是否连通、DTLS 是否完成 | 检查信令日志和 connectionState,确认候选已正确添加 |
| A 能发送但 B 没有消息 | B 是否监听 datachannel 与 message |
在接收端绑定事件后再发起协商 |
| 消息只出现一次 | 是否把 send() 当成双向确认 |
增加 PING、PONG、ACK 三段消息 |
候选对包含 relay |
TURN 是否参与选中路径 | 如需测试直连,检查 NAT 条件和候选对选择;不要直接判为故障 |
| relay-only 模式连接失败 | TURN 凭据、端口、传输协议与服务器可达性 | 检查 TURN 分配与 ICE 检查,确认服务端允许对应传输 |
| 找不到候选对统计 | 浏览器版本、统计字段、采样时机 | 等待连接稳定,结合浏览器 WebRTC 诊断页面核对 |
验收记录至少保留两端 DataChannel 状态、消息 ID 的完整确认链、选中候选对的本地与远端类型,以及是否启用了 relay-only 测试。只有应用消息得到双向确认,并且候选对统计与预期传输模式一致,才能认为本次 DataChannel 数据传输验证通过。