使用react-native-ble-manager的write()方法时出现status=3错误

status=3 是什么意思 #

在react-native-ble-manager的BLE通信体系里，status=3对应的是GATT_WRITE_NOT_PERMITTED——说白了就是你要写入的那个特征（Characteristic）不允许写操作，或者你没拿到正确的写入权限。

一步步排查解决 #

1. 先确认目标特征支持写入 #

打开你的peripheral对象，找到要写入的服务（Service）下的对应特征，检查它的properties字段，必须包含Write或者WriteWithoutResponse。

// 检查特征属性示例
const targetCharacteristic = peripheral.services
  .find(svc => svc.uuid === "你的服务UUID")
  ?.characteristics.find(char => char.uuid === "你的特征UUID");
console.log(targetCharacteristic?.properties); // 需包含'Write'或'WriteWithoutResponse'

要是没有这俩属性，那就是设备端的BLE配置不让写，要么改设备固件，要么换个支持写入的特征。

2. 用对写入方法 #

特征支持的写入类型决定了你该用哪个API：

• 支持Write：用BleManager.write()（带响应的写入）
• 只支持WriteWithoutResponse：必须用BleManager.writeWithoutResponse()，不能用默认的write方法

给你个async/await的示例：

async function sendCom(peripheralId, serviceUUID, charUUID, data) {
  try {
    // 先获取特征信息确认属性
    const char = await BleManager.retrieveCharacteristic(peripheralId, serviceUUID, charUUID);
    if (char.properties.includes('WriteWithoutResponse')) {
      await BleManager.writeWithoutResponse(peripheralId, serviceUUID, charUUID, data);
    } else if (char.properties.includes('Write')) {
      await BleManager.write(peripheralId, serviceUUID, charUUID, data);
    } else {
      throw new Error('该特征不支持写入操作');
    }
    console.log('写入成功');
  } catch (err) {
    console.error('写入失败:', err);
  }
}

3. 检查数据格式对不对 #

BLE对写入数据的要求很严格：

• 必须是Uint8Array类型，字符串要先转换：

// 字符串转Uint8Array示例
const sendData = new TextEncoder().encode("你要发送的指令");

• 数据长度不能超过设备的MTU值，太长的话得分块写入。

4. 确认连接和权限没毛病 #

• 别只说连接上了，写入前再确认下状态：

const isConnected = await BleManager.isConnected(peripheralId);
if (!isConnected) {
  await BleManager.connect(peripheralId);
}

• 确保APP获取了蓝牙权限：Android需要BLUETOOTH_CONNECT和BLUETOOTH_SCAN权限；iOS要在Info.plist中添加NSBluetoothAlwaysUsageDescription配置。

5. 核对UUID有没有写错 #

服务UUID和特征UUID必须和peripheral对象中的完全一致，注意大小写（BLE UUID通常为小写），UUID错误会导致找不到特征，进而触发类似权限错误。

最后排查步骤 #

要是上面都试过还不行：

• 重启BLE设备和APP，清除蓝牙缓存
• 用nRF Connect这类BLE调试工具测试该特征是否能正常写入，排除设备本身的问题

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