Web Bluetooth API的WriteWithResponse在蓝牙5.1/5.2/5.3下无法工作

Unexpected GattCommunicationStatus: 3对应连接超时或通信中断，这类问题在蓝牙5.1+设备上出现，通常和协议适配、MTU（最大传输单元）不匹配、驱动兼容性有关，以下是具体排查和修复方案：

1. 强制调整MTU大小 #

蓝牙5.0默认MTU较小，5.1+支持更大MTU，但部分设备或Web蓝牙实现可能协商失败。在连接后手动设置MTU为蓝牙5.0标准值，跳过自动协商：

function onButtonClick() {
 console.log('Requesting Bluetooth Device...');
 navigator.bluetooth.requestDevice(
  {filters: [{services: [serviceUUID]}]})
 .then(device => {
  return device.gatt.connect();
 })
 .then(server => {
  // 强制设置MTU为23，避免5.1+设备协商逻辑冲突
  return server.device.gatt.requestMTU(23).then(() => server);
 })
 .then(server => {
  return server.getPrimaryService(serviceUUID);
 })
 .then(service => {
  return service.getCharacteristic(characteristicWriteUUID);
 })
 .then(characteristic => {
  let msg = new TextEncoder('utf-8').encode('Z');
  return characteristic.writeValueWithResponse(msg);
 })
 .then(()=> {
  console.log('write successfully')
 })
 .catch(error => {
  console.log( error);
 });
}

2. 排查驱动与Chrome版本 #

• 升级PC蓝牙驱动至最新版本：蓝牙5.1+的驱动常带兼容性补丁，旧驱动可能无法正确处理Web蓝牙的GATT请求。
• 升级Chrome到最新稳定版：Web蓝牙API对新蓝牙版本的支持随浏览器版本迭代，旧版本可能存在协议适配bug。

3. 检查设备端协议实现 #

部分蓝牙设备在处理5.1+主机的WriteWithResponse请求时，存在ACK确认机制的兼容性问题：

• 确认设备端是否支持蓝牙5.1+的ATT扩展，若仅兼容5.0，需关闭设备端5.1+相关特性。
• 调整设备端Write请求的超时时间，延长ACK等待时长。

4. 带重试的写入替代方案 #

如果上述方法无效，尝试添加重试逻辑，应对偶发的通信中断：

// 带重试的写入函数
async function writeWithRetry(characteristic, data, retries = 3) {
  for (let i = 0; i < retries; i++) {
    try {
      await characteristic.writeValueWithResponse(data);
      return true;
    } catch (e) {
      if (i === retries - 1) throw e;
      await new Promise(resolve => setTimeout(resolve, 100));
    }
  }
}

// 修改原调用逻辑
.then(characteristic => {
  let msg = new TextEncoder('utf-8').encode('Z');
  return writeWithRetry(characteristic, msg);
})

5. 验证硬件兼容性 #

部分PC的蓝牙5.1+模块存在硬件层面的Web蓝牙兼容性问题：

• 更换其他品牌的蓝牙5.1+模块，确认是否为特定硬件bug。
• 在PC蓝牙设置中禁用BLE扩展广告、增强连接等5.1+特性，切换到兼容模式。

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