蓝牙小程序开发教程：别被官方文档坑了，老鸟带你避坑指南

本文关键词：蓝牙小程序开发教程

干建站这行十五年，见过太多老板花大价钱找外包，结果拿回来的代码跑都跑不通，或者连上蓝牙就断连，急得直跳脚。其实蓝牙小程序开发教程这东西，网上教程一搜一大把，但真能落地的没几个。今天我不整那些虚头巴脑的理论，就说说我在项目里踩过的坑，顺便把蓝牙小程序开发教程里最核心的几个硬骨头给你啃下来。

很多新手一上来就照着官方文档敲代码，结果发现手机搜不到设备，或者搜到了连不上。为啥？因为蓝牙这玩意儿，底层逻辑跟Wi-Fi完全不一样。它不是长连接，是短连接，而且对权限要求极高。你得先搞清楚，用户得手动触发连接，不能后台静默连，这是微信的安全红线，谁碰谁死。

先说搜索设备。别一上来就搞全局搜索，耗电不说，还容易卡死。你得用wx.startBluetoothDevicesDiscovery，设置allowDuplicatesKey为false，这样能过滤掉重复广播，省资源。这里有个细节，很多教程没提，就是timeout参数。如果你设得太短，比如1000毫秒，在信号弱的地方，根本搜不到设备。我一般建议设到3000到5000毫秒，稳一点。还有，搜索完一定要记得wx.stopBluetoothDevicesDiscovery，不然蓝牙模块会一直在那儿耗电，用户手机发烫，投诉立马就到。

接下来是连接。连接失败是常态，特别是那种几十块钱的杂牌蓝牙模块。你得做好重试机制。别只连一次就放弃，我见过最笨的做法是连不上就弹窗提示“连接失败”，然后让用户重开小程序。这体验太差了。正确的做法是，捕获异常，间隔几百毫秒重试三次。如果还不行，再提示用户。这里要注意，连接成功后，你得立刻获取服务列表wx.getBLEDeviceServices，别急着读特征值，服务列表里才有你需要的UUID。很多小白直接拿个UUID去读，结果报错，因为那个UUID根本不存在于当前设备的服务中。

数据收发这块，坑更多。写入数据用wx.writeBLECharacteristicValue，读取数据得用wx.onBLECharacteristicValueChange监听。这里有个大坑，监听器一旦注册，就会一直触发。如果你不处理，数据量大点，小程序直接卡崩。你得加个节流，或者只在你需要的时候才监听。另外，写入数据时，如果数据超过20字节，得分包发送。官方文档里没细说，但实际开发中，大部分蓝牙模块都支持MTU协商，如果协商失败，你就得自己切分数据包。我一般把数据包切成18字节一组，加上指令头，这样兼容性最好。

还有，蓝牙权限。现在微信对隐私抓得严，你得在app.json里配置permission，或者在代码里动态申请。如果用户拒绝权限，你得引导他去设置里开启，别直接报错。这个引导页面做得人性化点，用户才愿意配合。

最后说点实在的，调试蓝牙，真机调试是必须的。模拟器根本模拟不了蓝牙信号。你得准备几台不同品牌的手机，iOS和Android都要测。iOS的蓝牙机制和Android不太一样，iOS对后台扫描限制更严，一旦切后台，搜索就停了。所以你的UI交互设计要考虑到这一点，比如连接成功后，再让用户切后台，或者提示用户保持前台运行。

做蓝牙小程序开发教程，光看文档没用，得多测。我手头有个项目，用了个国产蓝牙模块，刚开始怎么连都不稳，后来发现是固件版本太老，升级固件后，秒连。所以，别光盯着代码，硬件也得配合。

总之，蓝牙开发就是个细活，耐心点。别指望复制粘贴就能跑通，每个项目的需求都不一样。把基础打牢，遇到坑自己填，这才是正经搞技术的态度。希望这篇蓝牙小程序开发教程能帮你省点头发，少掉几根。