蓝牙设置最大传输单元失效，每次只能传输20个字节。uni.setBLEMTU

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

根据你的描述，uni.setBLEMTU 虽然走到了 success 回调，但实际传输单元（MTU）仍然是默认的 20 字节，而蓝牙调试助手修改 MTU 后能生效。这是一个在 uni-app 蓝牙开发中的已知兼容问题，尤其在某些 Android 设备（如华为部分机型）上会出现。

主要原因

• 部分 Android 手机系统/蓝牙芯片 对 BLE MTU 协商的支持或实现存在差异，即使 setBLEMTU 返回成功，底层也可能没有真正协商成功。
• 调用时机不当：如果在连接成功后立即调用 setBLEMTU，可能底层还未准备好，导致看似成功但实际未生效。
• uni-app 的 BLE API 封装 在某些系统版本上可能存在行为不一致（已有多个反馈帖，如 ask#185271 和 ask#200929）。

解决思路（按推荐顺序）

1. 延迟调用 setBLEMTU
   在 createBLEConnection 成功后等待 500~1000ms 再设置 MTU，有时还需要在 getBLEDeviceServices 成功后再调用。参考社区分享 文章#40296：

   uni.createBLEConnection({  
    deviceId: deviceId,  
    success() {  
      setTimeout(() => {  
        uni.setBLEMTU({  
          deviceId: deviceId,  
          mtu: 256, // 范围 22~512  
          success: (res) => {  
            console.log('setMTU success', res);  
            // 这里再去获取服务、写入数据  
          }  
        });  
      }, 1000);  
    }  
   });  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

2. 使用 UTS 插件直接调用原生接口
   如果延迟也不起作用，而原生调试工具能正常设置 MTU，说明 uni-app 的 API 在此设备上存在限制。可以通过 UTS 插件直接封装 BluetoothGatt.requestMtu()（Android）或对应 iOS 能力，避开 uni-app 的 API 层。插件市场已有现成蓝牙插件集成了 MTU 设置，例如：

   • 搜索关键词「mushan-bluetooth」插件（链接：https://ext.dcloud.net.cn/search?q=mushan-bluetooth），该插件提供了 UTSrequestMtu 方法，支持 uniapp 和 uniapp x，并在文档中说明了双端 MTU 的差异及处理建议。
   • 如果你熟悉原生开发，也可以自己写 UTS 插件调用 BluetoothGatt.requestMtu()，插件市场参考：https://ext.dcloud.net.cn/search

3. 采用分包发送作为兜底方案
   若设备确实无法支持更大 MTU（尤其 iOS 或某些低功耗设备），就只能按 20 字节分包发送。虽然效率降低，但兼容性最好。注意并行写入可能导致错误，务必串行化（async/await 顺序写入）。

4. 验证设备和系统支持
   用蓝牙调试助手（如 nRF Connect）确认设备是否真的支持更大 MTU，且协商后 MTU 是多少。如果调试助手也无法设置，则是设备或系统限制，非代码问题。

补充提示

• 官方文档 uni.writeBLECharacteristicValue 注意事项提到：“APP不会对写入数据包大小做限制，但系统与蓝牙设备会限制蓝牙4.0单次传输的数据大小”，建议每次写入不超过 20 字节，这暗示了 MTU 设置可能在某些情况下不生效，开发时应做好分包兼容。
• 已知部分华为机型（如 Mate 30、Pura 70 等）在多篇 bug 反馈中报告 setBLEMTU 失效，可关注后续 HBuilderX 版本更新或议题 issues#200929 的进展。

如果你的项目是 uni-app x，则可以直接使用上述 UTS 插件，或参考其提供的 MTU 设置示例。希望这些方法能帮你解决 MTU 设置失效的问题。