计算机网络 / 系统课时
设备上线后怎样注册身份
设备上线后怎样注册身份
设备建立 WebSocket 连接后,服务端首先拿到的只是一次临时连接。要让后续状态同步、命令下发和重连恢复稳定工作,需要把长期不变的 deviceId、设备能力 capability 与本次连接的 connectionId 建立明确映射,并处理重复上线与旧连接迟到关闭的问题。
学习目标
- 区分稳定设备标识
deviceId与短生命周期connectionId。 - 校验
capability后建立设备到连接、连接到设备的双向映射。 - 正确处理同一设备重连,避免旧连接关闭事件误删新会话。
注册流程为什么不能只保存 connectionId
connectionId 只代表一次 WebSocket 会话。网络切换、进程重启或代理重连后,它通常都会变化;如果业务状态直接绑定这个值,设备一重连就会被当成“另一台设备”。真正稳定的业务主键应是经过认证的 deviceId。
capability 用来描述当前设备允许参与的能力集合,例如 telemetry、command、ota。服务端可以据此决定是否接收某类上报或下发某类命令,但客户端声明不能直接当成授权结果,仍应经过白名单或认证信息校验。

注册时同时维护正向和反向索引
下面的示例实现一个最小设备注册表。它先确认 connectionId 确实由当前服务创建,再校验 deviceId 与 capability,最后同时维护 deviceId -> session 和 connectionId -> deviceId。当同一设备用新连接重新注册时,新会话覆盖旧会话。
const ALLOWED_CAPABILITIES = new Set(["telemetry", "command", "ota"]);
class DeviceRegistry {
constructor() {
this.liveConnections = new Set();
this.byDeviceId = new Map();
this.byConnectionId = new Map();
}
connect(connectionId) {
this.liveConnections.add(connectionId);
}
register(connectionId, message) {
if (!this.liveConnections.has(connectionId)) {
return { ok: false, reason: "invalid connectionId" };
}
const { deviceId, capability } = message;
const validDeviceId =
typeof deviceId === "string" &&
/^[A-Za-z0-9:_-]{1,64}$/.test(deviceId);
const validCapability =
Array.isArray(capability) &&
capability.length > 0 &&
capability.every((item) => ALLOWED_CAPABILITIES.has(item));
if (!validDeviceId || !validCapability) {
return { ok: false, reason: "invalid registration payload" };
}
const boundDeviceId = this.byConnectionId.get(connectionId);
if (boundDeviceId && boundDeviceId !== deviceId) {
return { ok: false, reason: "connection already registered" };
}
const previous = this.byDeviceId.get(deviceId);
// 同一设备重连时,先解除旧 connectionId 的反向映射。
if (previous && previous.connectionId !== connectionId) {
this.byConnectionId.delete(previous.connectionId);
}
const session = {
deviceId,
connectionId,
capability: [...new Set(capability)]
};
this.byDeviceId.set(deviceId, session);
this.byConnectionId.set(connectionId, deviceId);
return {
ok: true,
replacedConnectionId:
previous && previous.connectionId !== connectionId
? previous.connectionId
: null
};
}
disconnect(connectionId) {
this.liveConnections.delete(connectionId);
const deviceId = this.byConnectionId.get(connectionId);
this.byConnectionId.delete(connectionId);
if (!deviceId) return;
const current = this.byDeviceId.get(deviceId);
// 只有当前会话仍指向该连接时才删除,防止旧 close 事件误删新连接。
if (current && current.connectionId === connectionId) {
this.byDeviceId.delete(deviceId);
}
}
getByDeviceId(deviceId) {
return this.byDeviceId.get(deviceId) ?? null;
}
}
const registry = new DeviceRegistry();
registry.connect("conn-1");
console.log(
registry.register("conn-1", {
deviceId: "sensor-17",
capability: ["telemetry", "command"]
})
);
registry.connect("conn-2");
console.log(
registry.register("conn-2", {
deviceId: "sensor-17",
capability: ["telemetry", "command"]
})
);
registry.disconnect("conn-1");
console.log(JSON.stringify(registry.getByDeviceId("sensor-17")));预期输出
{ ok: true, replacedConnectionId: null }
{ ok: true, replacedConnectionId: 'conn-1' }
{"deviceId":"sensor-17","connectionId":"conn-2","capability":["telemetry","command"]}最后一行仍然指向 conn-2,说明旧连接的关闭事件没有把新会话删掉。这是设备重连场景里非常重要的竞态保护。
把认证、注册和状态同步分成三个边界
推荐顺序是:连接建立后先完成设备认证,再接受注册消息,最后才允许状态上报和命令通道进入业务处理。注册消息可以长这样:
{
"type": "register",
"deviceId": "sensor-17",
"capability": ["telemetry", "command"]
}这是数据结构示例,不单独产生控制台输出。生效时,服务端应以认证结果确认 deviceId 是否属于当前设备,并只保留服务端允许的 capability;验证方法是注册成功后按 deviceId 查询,必须得到当前最新的 connectionId。
用 deviceId 驱动后续业务
状态同步、在线状态和命令路由应以 deviceId 作为稳定键,再由注册表解析出当前连接。这样重连只会替换会话,不会改变业务身份;同一设备的新连接生效后,旧连接迟到的关闭事件也不会清掉新状态。
如果系统允许一台设备同时保持多个连接,就不能再使用单值 deviceId -> connectionId,而应改成设备到连接集合,并定义主连接、能力分流或多播规则。对于常见的单设备单会话模型,上面的“新连接覆盖旧连接 + 条件式断线清理”已经能建立稳定且可验证的身份注册链路。