uni.closeBLEConnection() 必须传入正确的 deviceId 才能断开连接,否则静默失败,导致后续报错10006或10003;需配合 uni.closeBluetoothAdapter() 释放资源,并注意 Android 12+ 需单独申请 BLUETOOTH_CONNECT 权限。

uni.closeBLEConnection() 必须传 deviceId 才能断开连接
不传 deviceId 或传错值,调用 uni.closeBLEConnection() 会静默失败,设备仍保持连接状态,后续再连可能报错 10006(连接中)或 10003(无效 deviceId)。
常见错误写法:
uni.closeBLEConnection({}) // ❌ 缺少 deviceId,无效果
uni.closeBLEConnection({ deviceId: 'xxx' }) // ✅ 正确,但需确保 'xxx' 是当前已连接设备的 deviceId
- 必须使用之前
uni.createBLEConnection()成功后拿到的deviceId,不能用uni.getBluetoothDevices()返回的任意 deviceId - 多个设备同时连接时,要逐个调用,不能批量断开
- iOS 上若设备已物理断电或超出范围,调用该方法可能触发
fail回调,但连接实际已失效,可忽略
断开后记得调用 uni.closeBluetoothAdapter() 释放资源
只断开单个设备连接(uni.closeBLEConnection())并不等于关闭蓝牙模块。系统底层蓝牙句柄仍被占用,尤其在 Android 上容易导致下次搜索失败、报错 10001(适配器不可用)或扫描超时。
正确清理顺序是:
- 先调用
uni.closeBLEConnection({ deviceId }) - 再调用
uni.closeBluetoothAdapter() - 两者都建议加
success和fail处理,避免因某一步失败阻塞后续逻辑
示例:
uni.closeBLEConnection({
deviceId: this.deviceId,
success: () => {
console.log('BLE 连接已断开');
uni.closeBluetoothAdapter({
success: () => console.log('蓝牙模块已关闭'),
fail: err => console.warn('关闭蓝牙模块失败', err)
});
},
fail: err => console.warn('断开 BLE 连接失败', err)
});
小程序端断开连接后,onBLEConnectionStateChange 可能延迟触发
微信小程序中,调用 uni.closeBLEConnection() 后,uni.onBLEConnectionStateChange() 监听器不一定立刻收到回调,有时延迟 1–3 秒,甚至不触发。不能依赖它来判断“是否已断开”。
更可靠的做法是:
- 以
uni.closeBLEConnection()的success回调为断开完成信号 - 主动清空本地缓存的
deviceId、serviceId、characteristicId等上下文变量 - 避免在
onBLEConnectionStateChange中重复执行断开逻辑(防止死循环)
Android 12+ 必须处理 BLUETOOTH_CONNECT 权限,否则断开操作可能被拦截
Android 12(API 31)起,uni.closeBLEConnection() 属于受保护的蓝牙操作,需要 BLUETOOTH_CONNECT 权限。即使你只做断开,没有申请该权限,部分机型(如小米、OPPO)会直接拒绝调用,且不抛错,fail 回调也不触发。
检查点:
-
manifest.json的 Android 配置中必须包含: - 运行时需手动请求该权限(
uni.authorize({scope: 'scope.bluetooth'})不覆盖此权限,需单独处理) - 华为/荣耀设备还可能额外要求开启「蓝牙扫描」和「后台弹出界面」权限,否则断开后无法再次发现设备
这个权限问题最容易被忽略——功能在开发机上正常,一发布就断连失败。











