WebBluetooth writeValue写入过慢且writeValueWithoutResponse报错

1. 先解决最核心的冗余GATT查询问题 #

你当前使用的写入函数存在严重性能浪费：每发送一个数据分块，都会重复执行getPrimaryService、getCharacteristic两次GATT查询操作。这两个操作都需要和蓝牙设备做交互，单次耗时几十到上百毫秒不等，按一张图拆成30个分块算，光这部分冗余操作就要消耗数秒，是速度慢的核心原因之一。
修复方案：
设备连接成功后，仅查询一次需要用到的服务、特征值实例，将实例缓存到内存中，后续所有写入操作直接调用缓存实例的写入方法，不要每次发送都重新查询。
参考改造后的JS逻辑：

// 全局缓存特征值实例，连接成功后初始化一次即可
let printChar = null;
async function initPrintChannel(deviceId, serviceId, characteristicId) {
  const device = getDevice(deviceId);
  if (!device.gatt.connected) throw new Error("设备未连接");
  const service = await device.gatt.getPrimaryService(serviceId);
  printChar = await service.getCharacteristic(characteristicId);
}

async function writeChunk(value) {
  if (!printChar) throw new Error("打印通道未初始化");
  if (!printChar.service.device.gatt.connected) {
    // 断连后走重连逻辑，不要直接sleep1秒递归
    await reconnectDevice();
    await initPrintChannel(/* 传入对应参数 */);
  }
  const data = Uint8Array.from(value);
  return printChar.writeValue(data);
}

把初始化逻辑放在设备GATT连接成功的回调里执行一次，后续发分块直接调用writeChunk传数据即可，这一步改完至少能砍掉60%以上的冗余耗时。

2. 正确使用无响应写入，不要直接替换API #

直接把writeValue替换为writeValueWithoutResponse报错，是因为你没提前校验特征值属性、匹配设备传输规则：

• 第一步先确认特征值支持的写入模式：拿到缓存的特征值实例后，先打印printChar.properties，如果writeWithoutResponse字段为false，说明该特征值本身不支持无响应写入，硬调必然报错，这种情况只能用带响应写入，配合后面的分块优化即可；如果字段为true，再继续做后续配置。
• 不要硬编码512字节作为分块大小：Web Bluetooth默认MTU很小，需要主动调用device.gatt.requestMtu(517)（对应512字节负载）协商MTU，实际单块可传输的字节数为协商后MTU值减3（GATT协议头开销）。大部分热敏打印机实际支持的MTU在128-255区间，硬塞512字节会导致底层协议栈拆包重传，不仅慢还容易触发GATT错误。
• 无响应写入必须配合流控：热敏打印机的蓝牙缓冲区普遍很小，一次性塞太多数据会直接丢包报错。不要逐块await等响应，也不要一口气把所有包全丢进去，用简单的队列控制发送节奏即可：

const sendQueue = [];
let isSending = false;
async function startSend() {
  if (isSending) return;
  isSending = true;
  while (sendQueue.length) {
    const chunk = sendQueue.shift();
    try {
      await printChar.writeValueWithoutResponse(chunk);
      // 每发10-15个块留5ms缓冲，匹配打印机处理速度，数值可以根据实际设备调整
      if (sendQueue.length % 12 === 0) {
        await new Promise(resolve => setTimeout(resolve, 5));
      }
    } catch (err) {
      // 写失败把块放回队首，等20ms重试
      sendQueue.unshift(chunk);
      await new Promise(resolve => setTimeout(resolve, 20));
    }
  }
  isSending = false;
}
// 所有分块直接入队，不用逐块等待
chunks.forEach(chunk => sendQueue.push(Uint8Array.from(chunk)));
startSend();

3. 针对性优化打印传输效率 #

• 分块对齐打印机行宽：不要按固定字节数硬切数据，58mm热敏打印机一行像素对应48字节，80mm机型对应72字节，把分块大小设为单行字节数的整数倍，避免打印机端做额外的拼包拆包处理。
• 发图前先查打印机状态：发送图像数据前，先发打印机的状态查询指令，等收到设备就绪的响应后再批量传数据，避免打印机处于走纸、加热忙状态时，传输过程中额外等待响应。
• 移除原逻辑中断连后sleep1秒递归重试的逻辑：断连后应该先走完整的重连、服务/特征值重缓存流程，再继续传输，不要每次写入失败都无脑等1秒，信号波动时这个逻辑会平白增加大量等待时间。

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