OpenHarmony 14 Ble蓝牙报错addService 2900099

一、先搞懂：2900099 到底是什么意思

在 OpenHarmony/HarmonyOS 的 BLE（低功耗蓝牙）子系统里，2900099 是通用错误码 Operation failed，文档里的官方说明是：

满足接口调用的前置依赖条件，或在某些场景下表示"指定的虚拟地址不存在"。

翻译成大白话就是：

你调用 gattServer.addService(）时，系统还没准备好，或者蓝牙本身没开、没初始化成功，所以这个操作失败了。

二、最常见的5个原因＋排查顺序

1. 蓝牙权限没给全／动态权限没申请

很多新手只在 module.json5 里写了权限，却忘了在代码里动态申请，或者权限配置不全。

正确的权限配置（ArkTS 里）:

// module.json5

"requestPermissions": [
  {
    "name": "ohos.permission.ACCESS_BLUETOOTH",
    "reason": "$string:bluetooth_permission_reason",
    "usedScene": {
      "abilities": ["EntryAbility"],
      "when": "inuse"
    }
  },
  {
    "name": "ohos.permission.ACCESS_FINE_LOCATION",
    "reason": "$string:location_permission_reason",
    "usedScene": {
      "abilities": ["EntryAbility"],
      "when": "inuse"
    }
  }
]

还要在代码里做动态申请：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
import type common from '@ohos.app.ability.common';

async function requestPermissions(context: common.UIAbilityContext) {
  const atManager = abilityAccessCtrl.createAtManager();
  // ...后续权限请求逻辑
}

权限给了没有，然后是GattServer注册了吗？

1. 蓝牙权限

• 确保蓝牙已开启：bluetooth.isBleEnabled()
• 动态申请权限：

ohos.permission.ACCESS_BLUETOOTH
ohos.permission.MANAGE_BLUETOOTH
ohos.permission.DISCOVER_BLUETOOTH

2. GattServer 必须先注册

// 正确流程
const gattServer = ble.createGattServer();
// 1. 先注册
await gattServer.registerServer();
// 2. 再 addService
await gattServer.addService(service);

参考下面例子运行一下：

import ble from '@ohos.bluetooth.ble';

async function setupBleServer() {
  // 1. 检查蓝牙
  if (!await ble.isBleEnabled()) {
    console.error('蓝牙未开启');
    return;
  }
  // 2. 创建并注册
  const gattServer = ble.createGattServer();
  await gattServer.registerServer();
  // 3. 构造服务
  const service: ble.GattService = {
    serviceUuid: '0000FFF0-0000-1000-8000-00805F9B34FB',
    serviceType: ble.ServiceType.PRIMARY,
    characteristics: [{
      characteristicUuid: '0000FFF1-0000-1000-8000-00805F9B34FB',
      permissions: ble.Permission.READ | ble.Permission.WRITE,
      properties: ble.Property.READ | ble.Property.WRITE | ble.Property.NOTIFY,
      descriptors: [{
        descriptorUuid: '00002902-0000-1000-8000-00805F9B34FB',
        permissions: ble.Permission.READ | ble.Permission.WRITE
      }]
    }]
  };
  // 4. 添加服务
  try {
    await gattServer.addService(service);
    console.log('addService 成功');
  } catch (e) {
    console.error(`addService 失败: ${e.code} ${e.message}`);
  }
}