BLE服务发现正确方法咨询及getUuid()空指针异常排查

嘿，这是BLE开发里超级常见的坑！你遇到的空指针，本质是要么在服务发现完成前就急着去拿服务，要么用的UUID和设备实际的服务UUID不匹配，导致getService()返回了null，之后调用getUuid()直接触发了异常。我给你梳理下正确的实现流程，帮你解决这个问题：

第一步：必须用BluetoothGattCallback监听服务发现状态 #

BLE的服务发现是异步操作，你不能连接设备后立刻去获取服务，得等系统告诉你服务发现完成了才行。所以一定要自定义一个BluetoothGattCallback，重点实现两个核心方法：

private BluetoothGattCallback gattCallback = new BluetoothGattCallback() {
    @Override
    public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
        super.onConnectionStateChange(gatt, status, newState);
        if (newState == BluetoothProfile.STATE_CONNECTED) {
            // 连接成功后，立刻触发服务发现——这是关键！
            boolean isDiscoverStarted = gatt.discoverServices();
            if (!isDiscoverStarted) {
                Log.e("BLE_DEBUG", "启动服务发现失败，检查设备连接状态");
            }
        } else if (newState == BluetoothProfile.STATE_DISCONNECTED) {
            // 断开连接后记得释放资源
            gatt.close();
        }
    }

    @Override
    public void onServicesDiscovered(BluetoothGatt gatt, int status) {
        super.onServicesDiscovered(gatt, status);
        if (status == BluetoothGatt.GATT_SUCCESS) {
            // 只有当服务发现成功（状态码为GATT_SUCCESS）时，才去获取服务和特征
            fetchTargetServiceAndChar(gatt);
        } else {
            Log.e("BLE_DEBUG", "服务发现失败，状态码：" + status);
        }
    }
};

第二步：修正你的Connect方法 #

你的Connect方法里，连接设备后不能立刻去操作服务，要把后续逻辑交给上面的回调。调整后的代码应该是这样：

@RequiresApi(api = Build.VERSION_CODES.JELLY_BEAN_MR2)
public void Connect(View view) {
    // 这里替换成你获取目标BluetoothDevice的逻辑，比如从扫描结果里拿
    BluetoothDevice targetDevice = Adapter.getRemoteDevice("你的设备MAC地址");
    if (targetDevice == null) {
        Log.e("BLE_DEBUG", "目标设备为空，检查设备地址是否正确");
        return;
    }

    // 连接设备时传入我们自定义的gattCallback
    BluetoothGatt gatt = targetDevice.connectGatt(this, false, gattCallback);
    if (gatt == null) {
        Log.e("BLE_DEBUG", "连接GATT服务器失败");
        return;
    }
}

第三步：安全获取服务和特征的方法 #

在onServicesDiscovered回调里调用的fetchTargetServiceAndChar方法，一定要先判空，避免空指针：

private void fetchTargetServiceAndChar(BluetoothGatt gatt) {
    // 替换成你要获取的服务UUID，注意格式要完全匹配！
    UUID serviceUuid = UUID.fromString("0000ffe0-0000-1000-8000-00805f9b34fb");
    BluetoothGattService targetService = gatt.getService(serviceUuid);

    // 先检查服务是否存在
    if (targetService == null) {
        Log.e("BLE_DEBUG", "找不到目标服务！请核对UUID是否正确");
        return;
    }

    // 再获取特征，同样要判空
    UUID charUuid = UUID.fromString("0000ffe1-0000-1000-8000-00805f9b34fb");
    BluetoothGattCharacteristic targetChar = targetService.getCharacteristic(charUuid);
    if (targetChar == null) {
        Log.e("BLE_DEBUG", "找不到目标特征！请核对UUID是否正确");
        return;
    }

    // 到这里就可以安全使用服务和特征了
    Log.d("BLE_DEBUG", "成功获取服务：" + targetService.getUuid().toString());
    Log.d("BLE_DEBUG", "成功获取特征：" + targetChar.getUuid().toString());
}

几个必须注意的细节 #

• 绝对不能跳过服务发现步骤：文档说的“先发现服务”是硬性要求，BLE设备不会主动把服务信息发给你，必须调用discoverServices()触发，然后等回调通知。
• UUID一定要核对准确：很多时候空指针不是因为流程错了，而是UUID写错了——比如漏了分隔符、用了16位UUID但没补全成128位格式，或者和设备实际的UUID不匹配。
• 权限要配全：Android 6.0+需要ACCESS_FINE_LOCATION权限，还要确保BLUETOOTH、BLUETOOTH_ADMIN权限都在Manifest里声明了。

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