Web Bluetooth断连主因是浏览器与系统蓝牙服务争抢控制权，非硬件故障；需协调OS后台服务、加连接延迟、检查2.4GHz共存配置。
HTML 函数运行时蓝牙断连 ≠ 硬件冲突，但可能触发底层资源争用
浏览器里调用 navigator.bluetooth.requestDevice() 或后续 device.gatt.connect() 时蓝牙突然断连，90% 不是蓝牙芯片坏了，也不是“硬件冲突”这种笼统说法能解释的。真实原因是 Web Bluetooth API 在请求连接或读写特征值时，会强制抢占系统蓝牙栈的控制权——如果此时有原生蓝牙进程（比如 Windows 的 Bluetooth Support Service、macOS 的 blued、Linux 的 bluetoothd）正在做扫描/配对/音频流传输，就会被踢下线。
- 常见错误现象：
BluetoothError: GATT operation failed for unknown reason或连接后几秒内device.ongattserverdisconnected被触发，同时系统托盘蓝牙图标变灰/显示“未连接” - 典型使用场景：Web 页面持续轮询心率传感器、调试 BLE 设备固件升级流程、多标签页同时打开蓝牙页面
- 关键参数差异：
requestDevice()的filters选项若为空（即不指定services），会触发全设备扫描，大幅增加与系统蓝牙服务的调度冲突概率
Windows/macOS/Linux 下蓝牙后台服务必须手动协调
不同系统对 Web Bluetooth 的权限模型和资源调度策略完全不同，不能靠“重启浏览器”解决。
- Windows：禁用
Bluetooth Support Service后 Web Bluetooth 可能完全不可用；但若该服务正忙于推送通知或耳机 A2DP 流，requestDevice()就会失败。建议在调试时临时关闭 Teams、Zoom、Spotify 等可能占用蓝牙的软件 - macOS：
blued进程默认不允许网页独占 GATT 通道。需确保“系统设置 > 蓝牙”中未启用“自动连接到已知设备”，否则网页发起连接时系统会抢回控制权 - Linux：依赖
bluez版本 ≥ 5.65，且必须启用ExperimentalFeatures=true并重启bluetoothd；否则connect()会静默超时，日志里只有Failed to connect: Connection refused
requestDevice() 后立即调用 device.gatt.connect() 是高危操作
很多代码习惯性在 await requestDevice() 返回后立刻 await device.gatt.connect()，这在低功耗设备（如体温计、电子秤）上极易失败——因为设备刚被发现，还没完成广播包解析或连接参数协商。
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 正确做法：加 100–300ms 延迟再 connect，例如
await new Promise(r => setTimeout(r, 200)) - 更稳妥方案：监听
device.onadvertisementreceived（Chrome 123+），确认设备广播稳定后再连接 - 性能影响：不加延迟时，在 ESP32-C3 等芯片上连接失败率可达 60%；加延迟后降至 5% 以内
- 兼容性注意：Safari 完全不支持 Web Bluetooth，
if (!navigator.bluetooth)必须前置判断，否则直接报Cannot read property 'requestDevice' of undefined
无线模块干扰排查要盯住 2.4GHz 共存机制，不是“换个 USB 口”就完事
Wi-Fi（尤其是 2.4G 频段）、USB 3.0 接口、无线鼠标接收器确实会影响蓝牙信号，但 Web 场景下的“断连”往往不是丢包，而是连接被主动终止。真正需要检查的是共存协议是否启用。
立即学习“前端免费学习笔记（深入）”；
- Windows：运行
netsh wlan show settings，确认Auto Configuration Wireless Mode为Enabled；若为Disabled，Wi-Fi/BT 共存逻辑失效，蓝牙会频繁掉线 - Linux：检查
/sys/kernel/debug/ieee80211/phy0/bt_coex_active是否为Y；若为N，需加载btusb模块时加参数enable_autosuspend=0 - 物理层排查优先级：先拔掉 USB 3.0 设备（特别是移动硬盘）、把 Wi-Fi 路由器信道固定在 1/6/11，最后再考虑蓝牙适配器换位置——多数情况下，软件层共存配置没开，换天线也没用
