计算机网络 / 系统课时

设备上线后怎样注册身份

设备上线后怎样注册身份

设备建立 WebSocket 连接后,服务端首先拿到的只是一次临时连接。要让后续状态同步、命令下发和重连恢复稳定工作,需要把长期不变的 deviceId、设备能力 capability 与本次连接的 connectionId 建立明确映射,并处理重复上线与旧连接迟到关闭的问题。

学习目标

  • 区分稳定设备标识 deviceId 与短生命周期 connectionId。
  • 校验 capability 后建立设备到连接、连接到设备的双向映射。
  • 正确处理同一设备重连,避免旧连接关闭事件误删新会话。

注册流程为什么不能只保存 connectionId

connectionId 只代表一次 WebSocket 会话。网络切换、进程重启或代理重连后,它通常都会变化;如果业务状态直接绑定这个值,设备一重连就会被当成“另一台设备”。真正稳定的业务主键应是经过认证的 deviceId。

capability 用来描述当前设备允许参与的能力集合,例如 telemetry、command、ota。服务端可以据此决定是否接收某类上报或下发某类命令,但客户端声明不能直接当成授权结果,仍应经过白名单或认证信息校验。

设备身份注册与重连替换时序

注册时同时维护正向和反向索引

下面的示例实现一个最小设备注册表。它先确认 connectionId 确实由当前服务创建,再校验 deviceId 与 capability,最后同时维护 deviceId -> session 和 connectionId -> deviceId。当同一设备用新连接重新注册时,新会话覆盖旧会话。

js
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")));

预期输出

text
{ ok: true, replacedConnectionId: null }
{ ok: true, replacedConnectionId: 'conn-1' }
{"deviceId":"sensor-17","connectionId":"conn-2","capability":["telemetry","command"]}

最后一行仍然指向 conn-2,说明旧连接的关闭事件没有把新会话删掉。这是设备重连场景里非常重要的竞态保护。

把认证、注册和状态同步分成三个边界

推荐顺序是:连接建立后先完成设备认证,再接受注册消息,最后才允许状态上报和命令通道进入业务处理。注册消息可以长这样:

json
{
  "type": "register",
  "deviceId": "sensor-17",
  "capability": ["telemetry", "command"]
}

这是数据结构示例,不单独产生控制台输出。生效时,服务端应以认证结果确认 deviceId 是否属于当前设备,并只保留服务端允许的 capability;验证方法是注册成功后按 deviceId 查询,必须得到当前最新的 connectionId。

用 deviceId 驱动后续业务

状态同步、在线状态和命令路由应以 deviceId 作为稳定键,再由注册表解析出当前连接。这样重连只会替换会话,不会改变业务身份;同一设备的新连接生效后,旧连接迟到的关闭事件也不会清掉新状态。

如果系统允许一台设备同时保持多个连接,就不能再使用单值 deviceId -> connectionId,而应改成设备到连接集合,并定义主连接、能力分流或多播规则。对于常见的单设备单会话模型,上面的“新连接覆盖旧连接 + 条件式断线清理”已经能建立稳定且可验证的身份注册链路。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设备上线后怎样注册身份

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通