# 适用于 IoT、可穿戴设备和创客硬件的在线 BLE 测试器
此 Web Bluetooth 扫描器可让您测试附近的蓝牙低功耗设备是否可从浏览器发现，以及授予权限后公开了哪些 GATT 服务。在调试 ESP32 固件、Arduino BLE 草图、智能传感器、健身可穿戴设备、键盘、自定义信标、环境监测器和原型硬件时非常有用，无需先构建原生移动应用。隐私模型
本网站不会存储 MAC 地址、设备 ID、名称、UUID、信号数据或扫描历史记录。浏览器权限选择器决定页面可以访问哪个单一设备，结果保留在当前浏览器会话中。
| 您看到的内容 | 含义 | 下一步检查 |
|---|---|---|
| 设备名称 | 硬件广播的蓝牙名称（如果有）。 | 如果为空，请检查固件广播数据或在测试期间使用已知的名称前缀。 |
| 设备 ID | 浏览器范围的标识符，而非原始公共 MAC 地址。 | 仅用于此浏览器会话；不要将其视为通用硬件序列号。 |
| GATT 服务 UUID | 接受连接后公开的服务组。 | 将标准 UUID 与 Bluetooth SIG 列表或您的固件服务表进行对比。 |
| 自定义服务 | 厂商特定或项目特定的 UUID。 | 打开您的固件、移动应用配置文件或 BLE 文档以映射特性和权限。 |
# 为什么浏览器蓝牙扫描有所不同
原生 BLE 扫描器应用通常显示来自许多附近设备的连续广播。Web Bluetooth 有意更加严格：页面必须在安全上下文中打开，扫描必须从用户点击启动，浏览器显示权限选择器。这保护用户免受静默跟踪，同时为开发人员提供了从 JavaScript 连接到选定 BLE 硬件的实用方式。Web Bluetooth 扫描器
最适合快速固件验证、演示、支持流程、课堂实验室和安装摩擦重要的基于浏览器的诊断。
原生 BLE 应用
更适合后台扫描、RSSI 记录、配对工作流、加密厂商协议、大型特性树和长期现场诊断。
# BLE 设备不出现的常见原因
- 蓝牙在操作系统级别已禁用，或浏览器没有蓝牙权限。
- 设备已连接到其他手机、笔记本电脑、厂商应用或网关，并已停止广播。
- 硬件仅在启动后或按下配对按钮后的短暂窗口期内广播。
- 浏览器不基于 Chromium，页面未通过 HTTPS 提供，或平台阻止了 Web Bluetooth。
- 固件广播制造商数据但隐藏了本地名称，因此选择器可能显示未命名设备。
- 设备需要绑定、加密或专有身份验证，服务才能可读。
# 调试期间如何使用 GATT UUID
服务 UUID 连接成功表示浏览器可以访问外设，并且外设至少公开了其 GATT 表的一部分。标准服务如电池服务、设备信息、心率、人机接口设备和环境感知很容易识别。自定义 UUID 通常指向固件特定功能，需要源代码或厂商文档中的特性映射。| 症状 | 可能原因 | 实用解决方案 |
|---|---|---|
| 权限选择器为空 | 设备未广播或缺少浏览器支持。 | 重启设备，启用配对模式，靠近或在 Chrome/Edge 中重试。 |
| 连接立即失败 | 设备忙碌、超出范围或拒绝浏览器连接。 | 断开厂商应用并将外设靠近计算机。 |
| 未列出服务 | GATT 不可用，服务被隐藏，或未授予这些 UUID 的访问权限。 | 在固件测试中添加已知的可选服务，或使用原生 BLE 工具检查。 |
| 仅出现自定义 UUID | 硬件使用厂商特定的固件服务。 | 将 UUID 映射到源代码常量并记录特性的读/写权限。 |
# 安全与隐私限制
- 页面无法在后台静默收集附近的蓝牙设备。
- 浏览器可能隐藏真实 MAC 地址，提供范围化的设备 ID。
- 访问仅在用户点击扫描按钮并选择设备后才开始。
- 结果不会被本网站上传或存储。
- 敏感的商用设备可能需要加密或厂商配对流程，此通用扫描器无法绕过。