Web 蓝牙连接失败？三步快速排查浏览器兼容性与设备状态

连不上。

真的，那种对着屏幕干瞪眼、刷新无数次却依旧看到“未找到设备”的挫败感，做物联网开发的谁没经历过？

别急着去怪罪硬件固件写得烂，也别马上怀疑是操作系统底层出了岔子。很多时候，问题就卡在浏览器那个看似简单实则坑多如麻的 Web Bluetooth API 调用链路上。

咱们今天不聊那些虚头巴脑的理论架构，直接把手伸进代码和浏览器的设置里去摸一摸，把那些阻碍连接的绊脚石一个个踢开。

第一步：把权限授权工作做到位

很多人一上来就写 navigator.bluetooth.requestDevice，结果控制台报个错就懵了。

慢着。

你得先搞清楚，浏览器可不是你想让它扫描就能扫描的。它是个守门员，而且是个极其谨慎的守门员。

要是你没有在用户发起的交互事件（比如点击按钮）中去触发这个请求，那浏览器压根就不会搭理你。这是安全策略的铁律。

开展授权管理工作的时候，必须确保代码逻辑是绑定在明确的点击事件回调当中的。

看看这个弹窗。

如果它根本没弹出来，那就说明你的触发机制有问题，或者是上下文环境不对。

还要注意一点，HTTPS 是硬性门槛。除非你是在 localhost 上进行调试，否则在非加密的 HTTP 协议下，任何尝试去调用蓝牙接口的行为都会被浏览器直接拦截。

这不是建议，是强制要求。

把站点部署到支持 SSL 的环境中去，或者干脆就在本地回环地址上跑，别让协议头成了拦路虎。

有些开发者会忽略 filters 参数的配置。

你要是把过滤条件写得太死，比如指定了某个具体的 Service UUID，而设备广播的数据包里头恰好没带这个字段（哪怕它实际上支持），那扫描结果就是空的。

这时候，试着放宽筛选条件，甚至先不填 filters，看看能不能扫到一堆设备。

要是能扫到，那就证明是过滤逻辑把自家设备给误杀了。

第二步：借助扫描检测工具验证兼容性

有时候，代码逻辑看着天衣无缝，可设备就是隐身。

这时候，别在自己的项目代码里死磕。

运用在线的 Web Bluetooth 测试工具，是个极其实用的法子。

这些工具剥离了你业务逻辑的干扰，单纯地测试浏览器与底层蓝牙栈的对话能力。

打开这类工具，点击扫描。

要是这里能列出一堆设备，包括你的目标硬件，那就说明浏览器的兼容性没问题，系统的蓝牙驱动也是活着的。

问题大概率出在你自己的 JavaScript 代码处理流程当中。

反过来，要是连这种纯测试页面都搜不到任何东西，那乐子就大了。

这可能意味着你的浏览器版本太老，根本不支持 Web Bluetooth API。

像某些老旧的 Firefox 版本或者未经特殊配置的 Safari，默认情况下是不开启这个特性的。

得去 about:flags 或者实验性功能页面里头，手动把 Web Bluetooth 相关的开关给打开。

还有种情况，就是操作系统层面的蓝牙服务挂了。

重启一下蓝牙适配器，或者干脆重启电脑。

听起来很土，但往往能解决那些莫名其妙的状态卡死问题。

第三步：对连接结果进行深度验证

扫到了，不代表能连上。

这才是最搞心态的阶段。

设备列表里明明有它，一点连接，转圈圈，然后超时，或者直接抛出一个 NetworkError。

这时候，你需要开展对连接过程的细致观察工作。

盯着控制台看。

错误信息通常会告诉你到底是哪一环断了链子。

如果是 GATT operation failed，那多半是设备端的 GATT 表结构有问题，或者是特征值（Characteristic）的权限设置不对。

比如，你试图去写入一个只读的特征值，那肯定会被拒绝。

还得考虑距离因素。

别看信号格显示满格，实际数据传输时的信噪比可能早就崩了。

把设备拿近点，再试一次。

要是离得近了就能连上，那就是射频干扰或者发射功率的问题。

另外，有些设备在进入配对模式后，只会维持很短的时间窗口。

你要是动作慢了，它就自动退出广播状态了。

这种情况下，得让设备重新进入配对模式，然后马上执行扫描操作。

手速要快，姿势要帅。

还有一种容易被忽视的原因，就是设备已经被其他程序占用了。

手机上的 App、系统自带的蓝牙设置界面，甚至是后台挂着的另一个浏览器标签页，都可能死死抓住设备不放。

Web Bluetooth API 虽然强大，但它没法强行抢走已经被独占的连接。

进行清理占用资源的工作，把其他可能连接该设备的程序统统关掉，再试。

写在最后

排查蓝牙连接问题，其实就是个不断缩小包围圈的过程。

从权限到兼容性，再到具体的连接状态，每一步都得走实了。

别指望有一键修复的神器。

大多数时候，解决问题的钥匙就藏在那些不起眼的控制台报错信息里，或者是某个被你遗忘的复选框当中。

下次再遇到连不上的情况，按这三步走一遍。

多半能省下半天的抓狂时间。

毕竟，咱们的时间是用来写代码的，不是用来跟浏览器猜谜语的。