向GATT Server添加BLE服务成功，但mGATTServer中未查询到该服务

以下是针对该问题的排查方向和解决方案：

1. 检查mGattServer初始化是否正确 #

确保mGattServer是通过BluetoothManager正确初始化的，且操作前蓝牙适配器处于开启状态：

BluetoothManager bluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);
if (bluetoothManager != null) {
    mGattServer = bluetoothManager.openGattServer(this, new BluetoothGattServerCallback() {
        @Override
        public void onConnectionStateChange(BluetoothDevice device, int status, int newState) {
            super.onConnectionStateChange(device, status, newState);
        }
    });
}

如果mGattServer为null，后续所有服务操作都会失效，需先解决初始化问题。

2. 验证UUID的有效性和唯一性 #

• 确保SERVICE_UUID和CHARACTERISTIC_UUID是128位标准UUID，避免使用与系统内置BLE服务冲突的UUID。推荐使用自定义UUID，比如：

private static final UUID SERVICE_UUID = UUID.fromString("5f9b34fb-0080-8000-1000-0000ffe00000");
private static final UUID CHARACTERISTIC_UUID = UUID.fromString("5f9b34fc-0080-8000-1000-0000ffe00000");

• 避免重复添加相同UUID的服务，若之前已添加过同UUID服务，addService会返回false，需先调用mGattServer.clearServices()清空后再重新添加。

3. 调整服务添加的时机 #

• 确保服务添加操作是在mGattServer初始化完成后执行，不要在蓝牙适配器未开启、或GattServer未就绪的状态下调用addService。
• 部分设备的BLE栈要求服务需在设备连接前添加完成，若在onConnectionStateChange回调后才添加服务，可能导致服务无法被本地GattServer识别。

4. 排查系统BLE栈缓存问题 #

• 尝试重启蓝牙适配器：通过BluetoothAdapter.disable()关闭蓝牙，再调用enable()重新开启，清除系统BLE栈的缓存。
• 若问题仍存在，可尝试重启设备，修复可能的BLE栈异常。

5. 确认mGattServer实例的一致性 #

检查代码中是否存在其他地方对mGattServer重新赋值的情况，确保调用addService和getServices时使用的是同一个实例。

内容的提问来源于stack exchange，提问作者Lê Huy Hùng