uniapp中BLE连接成功却收不到设备通知数据？

Question

在 UniApp 中使用蓝牙（BLE）时，常遇到“连接成功但收不到设备通知数据”的问题。典型原因包括：① 未正确启用特征值的 notify/indicate 属性（需调用 `uni.notifyBLECharacteristicValueChange` 并传入 `state: true`）；② 设备端未开启对应特征值的通知功能或未触发数据上报；③ Android 端因系统限制（如 Android 12+ 需显式声明 `BLUETOOTH_CONNECT` 权限且需动态申请）导致监听失败；④ iOS 端未在 `didUpdateValueForCharacteristic` 回调中及时读取 `characteristic.value`，或特征值未配置为可通知（Properties 包含 Notify）；⑤ 特征值 UUID 大小写不一致、服务/特征/描述符层级查找错误，或未等待 `onBLEConnectionStateChange` 确认已连接稳定后再执行订阅。建议结合 `uni.getConnectedBluetoothDevices` 和日志逐层验证服务发现、特征获取与通知开启流程。

Answer 1

```html

一、现象层：连接成功但无通知数据——表象与初判

开发者调用 uni.createBLEConnection 返回 success，onBLEConnectionStateChange 触发 connected: true，但后续注册的 uni.onBLECharacteristicValueChange 从未触发。此为典型“静默连接”问题，非通信中断，而是数据通路未真正建立。需立即排除权限、状态时序与基础配置三类低阶阻断点。

二、权限与平台适配层：Android 12+ 与 iOS 的合规性鸿沟

• Android 12+：必须在 AndroidManifest.xml 中显式声明：
  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />，且运行时动态申请（uni.authorize({scope: 'scope.bluetoothConnect'})）；缺失则 notifyBLECharacteristicValueChange 静默失败，无错误回调。
• iOS：需在 ios/Info.plist 添加 NSBluetoothAlwaysUsageDescription，且首次调用前确保用户已授权；若未授权，onBLECharacteristicValueChange 不注册，亦无日志提示。

三、协议栈执行层：BLE 通信生命周期的严格时序依赖

BLE 通知启用非原子操作，必须遵循严格顺序：

1. 等待 onBLEConnectionStateChange 确认 connected === true；
2. 调用 uni.getConnectedBluetoothDevices 验证设备在线；
3. 执行 uni.getBLEDeviceServices → uni.getBLEDeviceCharacteristics；
4. 确认目标特征的 properties.notify === true（iOS 必须）；
5. 最后调用 uni.notifyBLECharacteristicValueChange({state: true, ...})。

任意环节跳过或异步竞态（如未 await 特征获取完成即开启 notify），均导致监听失效。

四、设备端协同层：双向契约不可单方面履行

检查项	常见陷阱	验证方式
通知使能寄存器	设备固件未将对应特征的 CCCD（Client Characteristic Configuration Descriptor）置位	使用 nRF Connect 扫描该特征，查看 “Enable notification” 是否可点击并生效
数据触发逻辑	设备仅在传感器采样、按键事件等条件下主动上报，空闲时不发包	用硬件调试工具抓包（如 Ellisys BLE Explorer），确认设备是否发出 ATT Handle Value Notification

五、UUID 与层级解析层：大小写、服务嵌套与描述符盲区

UniApp 对 UUID 大小写敏感（尤其 Android native 层），"0000FFF1-0000-1000-8000-00805F9B34FB" 与 "0000fff1-0000-1000-8000-00805f9b34fb" 被视为不同特征。更隐蔽的是：部分设备将 Notify 控制逻辑放在 Descriptor 层（如 0x2902），而非 Characteristic 层——此时必须通过 uni.getBLEDeviceCharacteristics 获取 descriptors 并手动写入 CCCD 值（0x0001）才能启用通知。

六、回调与数据消费层：iOS 的 value 提取陷阱与内存生命周期

// ❌ 错误：未在回调内读取 value，或读取后未转码
uni.onBLECharacteristicValueChange((res) => {
  console.log('收到变更', res); // 仅 log，未处理 value
});

// ✅ 正确：同步读取并解码
uni.onBLECharacteristicValueChange((res) => {
  const buffer = res.value;
  if (buffer) {
    const dataView = new DataView(buffer);
    const hex = Array.from(new Uint8Array(buffer)).map(b => b.toString(16).padStart(2, '0')).join('');
    console.log('原始数据:', hex);
  }
});

七、诊断流程图：结构化排错路径

flowchart TD
  A[连接成功] --> B{onBLEConnectionStateChange connected?}
  B -->|Yes| C[getConnectedBluetoothDevices]
  B -->|No| Z[重连/检查物理连接]
  C --> D[getBLEDeviceServices]
  D --> E[getBLEDeviceCharacteristics]
  E --> F{目标 characteristic.properties.notify == true?}
  F -->|No| Y[设备端不支持Notify，换Indicate或轮询]
  F -->|Yes| G[notifyBLECharacteristicValueChange state:true]
  G --> H{onBLECharacteristicValueChange 触发？}
  H -->|Yes| I[解析value并业务处理]
  H -->|No| J[查权限/UUID/CCCD/设备触发逻辑]

```