首页所有工具蓝牙诊断

Web 蓝牙连接与扫描测试

利用 Web Bluetooth API 在线扫描附近的蓝牙设备。测试浏览器的蓝牙连接、配对及数据传输能力（需硬件支持）。

环境与支持

Web Bluetooth
不支持 Web Bluetooth
安全上下文（HTTPS）
否
蓝牙可用性（getAvailability）
未知/不支持
User-Agent
-
你当前的浏览器可能不支持 Web Bluetooth
建议使用桌面版 Chrome / Edge（HTTPS 环境）。iOS Safari 通常不支持。
就绪设备:-
当前设备
名称: -
ID：-
连接:未连接
最近断开:-
广告/广播（可选）
部分 Chrome 版本/设备支持，用于观察 RSSI/广播是否持续。

GATT 服务 / 特征

共 0 个服务 / 0 个特征
还没有数据。请先 连接，再点击 枚举服务。

日志

暂无日志。建议点击“扫描设备”开始。

怎么用这个页面快速定位问题

• 先看“环境与支持”：必须在 HTTPS/安全上下文；推荐桌面版 Chrome/Edge。iOS Safari 通常不支持 Web Bluetooth。
• 扫描必须由“点击按钮”等用户手势触发；否则容易报 NotAllowedError 或被浏览器拦截。
• 连不上/频繁断连：靠近设备、减少遮挡与 2.4GHz 干扰；关闭系统蓝牙再开启或重启设备；避免被其它设备/应用占用连接。
• 枚举不到服务/特征：把目标服务加入 optionalServices（浏览器会限制未声明的服务访问）。
• 需要协助排查：点击“复制报告”，把 UA、状态、错误与日志一并提供给开发/客服。

蓝牙诊断测试指南

基于 Web Bluetooth 扫描、连接与 GATT 诊断，帮助排查配对失败、断连、服务不可见与兼容性问题。所有操作均在本地浏览器完成。

步骤 1

确认环境与浏览器支持

约 10 秒

确保在 HTTPS 下访问，并使用支持 Web Bluetooth 的浏览器。

在“环境与支持”卡片中确认：Web Bluetooth 为“支持”，并且“安全上下文（HTTPS）= 是”。
如果显示“不支持 Web Bluetooth”：请改用桌面版 Chrome/Edge；iOS Safari 通常不支持。
提示：Web Bluetooth 会受到浏览器/系统策略限制，不同平台差异很大。
步骤 2

扫描并选择设备

约 10–20 秒

点击“扫描设备”，在系统弹窗中选择你的蓝牙设备。

确保系统蓝牙已开启，并且目标设备处于可发现/可连接状态。
点击“扫描设备”（必须由点击触发，不能自动扫描）。
如找不到设备：可先勾选 acceptAllDevices；或使用 namePrefix/service 过滤精准定位。
步骤 3

连接并枚举 GATT 服务/特征

约 10–30 秒

连接成功后点击“枚举服务”，查看服务与特征列表。

点击“连接”，状态变为“已连接”。
点击“枚举服务”，在“GATT 服务 / 特征”卡片里查看列表。
若枚举不到目标服务：把服务 UUID 加入 optionalServices 后重新扫描/连接再试。
提示：很多浏览器会限制未在 optionalServices 声明的服务，即使设备真实存在也“看不到”。
步骤 4

读取/订阅通知并导出报告

约 20 秒

读取特征值、开启通知，最后复制报告用于进一步排查。

在特征列表中点击“读取”，观察返回的 hex/text 内容是否合理。
若特征支持 notify/indicate，可点击“开启通知”，观察日志是否持续收到数据。
遇到错误或需要协助：点击“复制报告”，把内容发给开发/客服定位。

常见问题解答

有疑问？我们有答案！以下是关于 Web Bluetooth 扫描、连接与 GATT 诊断的常见问题汇总。

1.

这个蓝牙诊断页能做什么？

它基于浏览器的 Web Bluetooth 能力，帮助你完成“扫描选择设备 → 连接 GATT → 枚举服务/特征 → 读取/订阅通知”，并记录关键日志与错误，便于定位配对失败、断连、服务不可见与兼容性问题。

2.

为什么提示“不支持 Web Bluetooth”？

Web Bluetooth 并非所有浏览器/平台都支持。通常桌面版 Chrome/Edge 支持较好；iOS Safari 通常不支持。你可以更换浏览器或换到桌面端再测。

3.

为什么必须在 HTTPS 下访问？

Web Bluetooth 属于高权限能力，浏览器要求安全上下文（HTTPS）。如果在 http 或不安全环境下，会触发 SecurityError 或直接不可用。

4.

为什么点“扫描设备”没反应/直接报 NotAllowedError？

扫描必须由用户手势触发（例如点击按钮），并且浏览器/系统需要允许蓝牙权限。请确保是你手动点击触发、系统蓝牙已开启、浏览器没有阻止权限弹窗。

5.

为什么扫描不到设备？

常见原因包括：设备未处于可发现/可连接状态、距离过远或遮挡、过滤条件过严（namePrefix/service）、或系统蓝牙被其它应用占用。建议先勾选 acceptAllDevices，靠近设备后再试。

6.

为什么连上了但“枚举不到服务/特征”？

浏览器会限制访问未声明的 GATT 服务。请把目标服务 UUID 加入 optionalServices（支持关键字如 battery_service，也可写完整 UUID），然后重新扫描/连接再枚举。

7.

为什么会频繁断连（NetworkError / InvalidStateError）？

常见原因是距离/干扰、电量低或设备省电休眠、蓝牙连接被其它设备抢占、或系统蓝牙栈不稳定。建议靠近设备、减少 2.4GHz 干扰、重启蓝牙/设备，并尽量保持单设备连接。

8.

开启“通知”后没有数据，是正常的吗？

可能正常。并非所有特征都会主动推送通知；有些需要先写入配置或在设备端触发事件。另外浏览器/设备也可能对 notify 事件有限制。你可以先尝试“读取”确认特征是否可读，或换一个已知会推送的特征验证链路。

9.

隐私安全吗？会上传我的蓝牙数据吗？

该页面主要在本地浏览器内进行交互与解析，不会主动上传你的蓝牙数据。若你点击“复制报告”，内容会进入剪贴板；你是否分享由你决定。

10.

“复制报告”包含哪些信息？

报告包含测试时间、浏览器 UA、HTTPS/可用性状态、扫描参数（过滤器/optionalServices）、设备信息摘要、枚举到的服务/特征结构、最近错误与日志记录。用于快速复现和定位问题。