Android外设BluetoothGattServerCallback的onServiceAdded()未触发问题

我之前在三星设备上开发BLE外设应用时，也碰到过类似的自定义服务不被中心设备识别的问题，结合我的排查经验，给你几个具体的解决方向：

1. 检查自定义服务UUID的正确性 #

BLE自定义服务必须使用128位UUID（不能用蓝牙SIG标准的16位UUID），而且格式要严格符合规范，比如0000xxxx-0000-1000-8000-00805f9b34fb这种格式。

• 代码里创建服务时，确保UUID字符串没有拼写错误：

  UUID customServiceUuid = UUID.fromString("你的128位自定义UUID");
  BluetoothGattService customService = new BluetoothGattService(customServiceUuid, BluetoothGattService.SERVICE_TYPE_PRIMARY);
  

2. 确认服务与特征的添加流程 #

• 必须先创建特征，将特征添加到服务中，再把服务添加到GattServer，顺序不能搞反：

  // 创建特征
  BluetoothGattCharacteristic customChar = new BluetoothGattCharacteristic(
          UUID.fromString("特征UUID"),
          BluetoothGattCharacteristic.PROPERTY_READ | BluetoothGattCharacteristic.PROPERTY_NOTIFY,
          BluetoothGattCharacteristic.PERMISSION_READ
  );
  // 特征添加到服务
  customService.addCharacteristic(customChar);
  // 服务添加到GattServer
  boolean isAdded = gattServer.addService(customService);
  // 这里可以打印isAdded，确认服务是否添加成功
  Log.d("BLE", "自定义服务添加结果：" + isAdded);
  

• 如果isAdded返回false，说明服务添加失败，大概率是UUID或属性配置有问题。

3. 适配三星设备的BLE外设限制 #

部分三星设备对外设模式下的自定义服务有特殊要求：

• 优先将自定义服务设为SERVICE_TYPE_PRIMARY，避免使用SERVICE_TYPE_SECONDARY，部分三星设备对次级服务的支持不佳。
• 确保广播数据中包含自定义服务的UUID，虽然广播正常，但添加UUID可以帮助中心设备更准确识别：

  AdvertiseData advertiseData = new AdvertiseData.Builder()
          .setIncludeDeviceName(true)
          .addServiceUuid(ParcelUuid.fromString("你的自定义服务UUID"))
          .build();
  

4. 确认服务添加时机 #

一定要在中心设备连接之前完成自定义服务的添加操作，也就是在调用BluetoothManager.openGattServer()之后，立刻创建并添加所有自定义服务，不要等到onConnectionStateChange回调触发后才添加——中心设备连接后会立即枚举服务，此时如果服务还未添加，就只会返回默认的Generic Attribute等服务。

5. 深挖LogCat日志 #

除了现有日志，过滤以下标签找线索：

• BluetoothGattServer：查看是否有服务添加失败的报错信息
• SamsungBluetooth：三星设备专属的BLE日志标签，可能会有设备特有的限制提示

按照上面的步骤逐一排查，应该能解决自定义服务不显示的问题。

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