使用Web Bluetooth GATT API的requestDevice无法通过自定义Service UUID过滤设备

问题描述 #

我无法通过Web Bluetooth GATT API的bluetooth.requestDevice方法，用自定义生成的Service UUID过滤设备。设备名为MyDevice1，服务UUID是随机生成的607cdd4f-32aa-47da-8209-18f12012e3a4。

仅用名称前缀过滤时能正常找到设备：

return navigator.bluetooth.requestDevice({
    filters: [{
        namePrefix: "MyDevice"
    }]
}).then......

但添加Service UUID过滤后就失效了：

return navigator.bluetooth.requestDevice({
    filters: [{
        namePrefix: "MyDevice",
        services: ["607cdd4f-32aa-47da-8209-18f12012e3a4"] // 匹配设备唯一的服务UUID
    }]
}).then......

已确认UUID完全正确，想搞清楚：是不是只能用预定义UUID过滤，自定义生成的UUID能不能用？测试用的是Chrome浏览器。

解答 #

自定义UUID完全可以用于Web Bluetooth的服务过滤，问题不在UUID本身，大概率是以下几个原因：

• 设备没广播该服务UUID：Web Bluetooth的服务过滤依赖设备把GATT服务UUID放到广播包里，或者支持连接后的服务发现请求。如果你的设备只在连接后才暴露这个服务，没在广播里声明，那requestDevice的services过滤就会失效——因为浏览器扫描阶段拿不到这个UUID。
• Chrome的权限或执行上下文限制：Web Bluetooth只能在HTTPS（或localhost）环境用，而且必须由用户主动触发（比如点击事件里调用）。如果代码不是在用户交互的逻辑里执行，可能会被浏览器拦截，导致过滤异常。
• UUID格式细节：虽然你确认UUID正确，但要注意它得是标准的128位带连字符的格式，大小写不敏感，再检查一遍有没有拼写错误。

验证步骤 #

1. 打开Chrome的chrome://bluetooth-internals/调试页面扫描设备，看设备广播的服务UUID列表里有没有你的自定义UUID。如果找不到，说明设备没广播这个服务，得改固件把UUID加进广播数据。
2. 试试单独用services作为过滤条件（去掉namePrefix），看能不能找到设备：

return navigator.bluetooth.requestDevice({
    filters: [{
        services: ["607cdd4f-32aa-47da-8209-18f12012e3a4"]
    }]
}).then......

3. 确认代码是在用户触发的事件（比如点击按钮）里执行的，避开浏览器的权限限制。

补充说明 #

Web Bluetooth对预定义UUID（比如16位的0x180D）和自定义128位UUID的处理逻辑是一样的，不存在只能用预定义UUID的限制。核心是设备得让浏览器在扫描阶段能获取到该服务UUID，或者支持连接后的服务发现（部分浏览器可能要求设备必须广播服务UUID才能过滤）。

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