锐智互动

微信小程序蓝牙设备连接与数据传输实践

在门禁巡检、医疗手环、仓储标签和工业采集器等场景中，手机或平板需要直接连接外设，完成配置、采集与控制。微信小程序无需安装、扫码即可使用，适合作为设备控制台和数据入口；难点集中在蓝牙发现、连接、服务发现、指令下发、通知订阅与断线恢复等连续环节。

可靠方案不能只验证“能连上”，还要覆盖权限、协议、时延、数据完整性和异常恢复。锐智互动网络科技有限公司可在需求分析阶段梳理硬件能力与业务流程，结合微信小程序、PC及移动应用、物联网和MES开发经验，提供从设计开发到部署运维的全流程支持。

对比维度 经典蓝牙 低功耗蓝牙 业务选型
连接方式 配对后建立点对点链路 通过广播发现并按需连接 小程序通常选择低功耗蓝牙
数据通道 常以串行流传输 按服务和特征读写 将命令与状态分配到不同特征
能耗表现 持续通信功耗较高 可采用间歇广播和休眠 电池设备优先评估低功耗方案
典型设备 传统外设与高带宽设备 传感器、标签、锁具和手环 按实时性、距离和续航综合选择

连接流程与平台能力

微信小程序蓝牙接口主要面向低功耗蓝牙，并不等同于传统经典蓝牙。开发前应确认设备模组和固件支持低功耗蓝牙广播，明确服务标识、特征标识及读写、通知属性，同时核对目标手机系统、微信版本和设备固件的兼容范围。

典型流程是初始化适配器、扫描目标、建立连接、获取服务与特征、订阅通知、写入指令，最后按需断开。可依次调用 wx.openBluetoothAdapter、wx.startBluetoothDevicesDiscovery、wx.createBLEConnection、wx.getBLEDeviceServices、wx.getBLECharacteristics、wx.notifyBLECharacteristicValue 与 wx.writeBLECharacteristicValue，并依据返回码推进连接状态。

扫描结果可能受到系统缓存、同名设备广播和权限状态影响，不能只凭名称判断目标。连接前应结合设备编号、广播服务标识和厂商数据识别设备，连接后再核对服务与特征。业务层还应维护“未初始化、扫描中、连接中、已连接、异常”等状态，避免重复操作触发并发连接。

通信架构与数据协议

蓝牙只是传输通道，业务数据应设计成稳定的协议帧。建议包含协议版本、消息类型、命令编号、流水号、数据长度、载荷和校验值；二进制设备可采用紧凑编码，调试阶段可使用JSON统一字段。设备端与小程序端需共享协议文档，明确字节序、时间格式、计量单位和错误码。

控制命令通常通过可写特征下发，设备状态通过通知特征主动推送。发送前必须完成通知订阅，否则可能出现“写入成功但收不到回执”。请求与响应需要通过流水号关联，并为超时、重发、重复包和乱序包设置处理规则；涉及状态变更的命令还应具备幂等机制，防止重试造成重复执行。

单次传输长度受特征值和协商后的最大传输单元限制。较大文件、固件片段或批量记录应按序号分包，在接收端重组并校验完整性；可通过 wx.setBLEMTU 尝试协商合适大小，再用 wx.getBLEMTU 确认结果。设备型号差异较大时，还可结合蓝牙连接案例核对连接表现，再确定分包与重试参数。

数据格式与可靠传输

数据字段应先定义语义再选择编码。传感器数值需注明单位、精度和异常值规则，时间字段需要统一时区，设备状态应采用固定枚举。JSON便于联调但占用空间较大，二进制更节省流量，却需要严格处理符号位、浮点精度和字段长度，生产环境可按数据量采用混合编码。

可靠传输不等于简单重试。每次写入都应记录流水号和发送时间，收到设备确认后再更新状态；超过等待时间才进入有限次数的指数退避重试。带序号的消息在接收端去重，带校验的消息在失败后丢弃，必要时由后台保存原始数据并补发。同一连接的写队列应串行控制，避免多个页面同时写入导致响应错配。

安全方面，设备密钥不应写在小程序代码包或日志中，配对密钥应由服务端按会话下发。涉及健康、位置或生产数据时，只采集业务必需字段，接口调用还要完成身份校验、权限判断与操作留痕。性能验收需同步观察连接成功率、往返时延、丢包率、重连次数和设备功耗，并区分蓝牙链路异常与后端处理异常。

权限配置与异常排查

权限问题常被误判为协议问题。发布前需在微信公众平台核对蓝牙接口权限并准备相应说明，真机还要确认系统蓝牙、位置或附近设备权限。不同手机厂商可能附加后台限制，iOS与Android的授权流程也不一致，测试账号应覆盖权限拒绝、授权后重试和应用切回前台等场景。

常见故障包括适配器不可用、扫描不到设备、连接超时、服务发现失败、写入无响应和通知不触发。排查时应保存接口名称、设备编号、错误码、时间戳、服务与特征标识以及协议流水号，同时记录设备广播状态。蓝牙功能无法由普通开发者工具完整模拟，关键路径必须在多款真机上验证。

恢复机制需要明确执行顺序。发生不可恢复错误时，先取消扫描、关闭连接，再关闭适配器，并按退避间隔重新初始化；短时中断可先尝试重连。心跳间隔应大于正常业务往返时间，连接队列还需防止多个重试任务同时运行。日志可汇总到自有监控平台，并与CRM、OA或数据可视化系统联动，按设备、固件和手机型号统计异常分布。

落地流程与交付验收

项目启动时应先产出设备能力清单、业务流程、蓝牙协议、异常码表和验收指标，再进入小程序、后端及硬件联调。开发阶段可利用模拟特征测试正常、超时和错误分支，随后切换真实设备验证广播、连接、订阅、写入、通知、断电重连和长距离场景。软硬件版本必须同步记录，避免问题无法复现。

交付后还要安排灰度发布和持续监测。固件与小程序可采用版本兼容策略，新旧设备保留必要适配窗口；后台保存设备状态、指令轨迹和配置版本，支持按编号追踪。对于医疗、制造、物流等连续运行场景，应明确故障降级、人工接管、数据补传和远程支持流程。

开发核对清单

上线验收清单