Android平台BluetoothGatt状态码133含义及BLE大MTU发送失败解决方案

错误码133的实际含义 #

Android官方文档未明确列出该错误码，但它属于BLE GATT层的通用错误。在三星设备的BLE栈中，这个错误通常对应MTU协商后发送端栈未同步更新传输尺寸限制：尽管onMtuChanged回调返回MTU=240，但实际发送缓冲区仍被限制在ATT协议默认的20字节payload（对应默认MTU23，减去3字节ATT头），导致超过该长度的写入请求被栈直接拒绝。

可行的解决办法 #

• 手动分片传输：
  计算单包最大可发送payload长度：MTU值 - 3（3字节为ATT层固定头），即240-3=237字节。将需要发送的大数据包拆分为若干个不超过237字节的分片，严格按顺序发送，且必须等待上一个分片的onCharacteristicWrite回调返回成功后，再发送下一个分片，避免栈请求拥堵。这是兼容性最强的解决方案，不受设备厂商栈差异影响。
• 重新同步BLE栈状态：
  在onMtuChanged回调确认MTU成功设置为240后，重新调用bluetoothGatt.discoverServices()，重新获取服务与特征实例。三星部分机型的BLE栈需要通过重新发现服务来触发MTU设置的实际生效。
• 调整特征写入类型：
  尝试将目标特征的写入类型改为无应答写入（如果业务场景允许），代码示例：

  targetCharacteristic.setWriteType(BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE);
  bluetoothGatt.writeCharacteristic(targetCharacteristic);
  

  部分三星设备的带应答写入（默认类型）对大尺寸数据包的兼容性较差，无应答模式可绕过部分栈限制。
• 禁用BLE硬件加速：
  在AndroidManifest.xml的<application>标签中添加android:hardwareAccelerated="false"，强制使用软件BLE栈。部分三星机型的硬件BLE栈存在MTU协商的适配bug，软件栈可规避该问题。
• 系统版本适配：
  部分旧版本三星One UI系统的BLE栈存在MTU协商后不生效的bug，建议测试设备升级至最新系统版本；若无法升级，可针对三星设备单独降低单包发送长度（例如限制为180字节），避免触发栈错误。

内容的提问来源于stack exchange，提问作者Flarosa