微信小程序调用蓝牙API “wx.writeBLECharacteristicValue()“ 报 errCode: 10008 的解决方案

1、问题现象  

  问题：在开发微信小程序蓝牙通信功能时，常常会遇到莫名其妙的错误，查阅官方文档可能也无法找到答案。如在写入蓝牙数据时，报了这样的错误：

{errno: 1500104, errCode: 10008, errMsg: "writeBLECharacteristicValue:fail:system error, status: UNKNOWN (239)"}，无从入手。

查阅官方文档，10008错误码给出的提示是：“其余所有系统上报的异常”

可能在苹果手机还好好的，到了安卓就不行了，其实啊，这是最大传输单元没有协商好的问题，我们仔细看下官网的注意事项大概能猜到：

2、问题分析

MTU（Maximum Transmission Unit，最大传输单元） 是指 BLE（Bluetooth Low Energy，低功耗蓝牙） 通信中 单次数据传输的最大字节数。它决定了设备之间一次能发送/接收多少数据，直接影响通信效率和速度。

   2.1. BLE MTU 的基本概念

• MTU = 协议头（3字节） + 有效数据（Payload）

  • 标准 BLE 4.0/4.1 的默认 MTU 是 23 字节（其中 3 字节用于协议头，实际有效数据只有 20 字节）。

  • BLE 4.2+ 支持更大的 MTU（如 247、512 甚至更高），但需要设备和手机都支持。

• MTU 越大，传输效率越高：

  • 如果 MTU=23，每次最多只能发 20 字节有效数据。

  • 如果 MTU=512，一次可以发 509 字节有效数据，减少分包次数，提高传输速度。

---

2.2. MTU 由谁决定？

MTU 不是单方面决定的，而是 手机（主机）和 BLE 设备（从机）协商 的结果：

• 手机（主机） 可以发起 MTU 请求（如 wx.setBLEMTU(512)）。
• BLE 设备（从机） 会返回它能支持的最大 MTU（如 185 字节）。
• 最终 MTU 取两者中的较小值（比如手机请求 512，设备支持 185，最终 MTU=185）