Android BLE中gatt.discoverServices()返回true但onServicesDiscovered未回调

1. 强制动态申请BLE危险权限 #

Android 12（API 31）及以上版本中，BLUETOOTH_SCAN和BLUETOOTH_CONNECT属于危险权限，仅在清单文件声明无法生效，必须主动向用户申请授权。即便部分BLE方法（如startDiscovery()、device.getName()）能临时运行，未授权仍会导致GATT服务发现等核心操作被系统拦截。

实现步骤：

• 在Activity/Fragment中使用ActivityResultContracts.RequestMultiplePermissions发起权限请求：

// Kotlin示例
val requestPermissionLauncher = registerForActivityResult(
    ActivityResultContracts.RequestMultiplePermissions()
) { permissions ->
    val scanGranted = permissions[Manifest.permission.BLUETOOTH_SCAN] ?: false
    val connectGranted = permissions[Manifest.permission.BLUETOOTH_CONNECT] ?: false
    if (scanGranted && connectGranted) {
        // 权限已授权，执行BLE连接操作
        connectToDevice(device)
    } else {
        // 提示用户需要权限才能使用功能
    }
}

// 在需要BLE操作前调用
requestPermissionLauncher.launch(
    arrayOf(
        Manifest.permission.BLUETOOTH_SCAN,
        Manifest.permission.BLUETOOTH_CONNECT
    )
)

2. 严格在连接成功回调中触发服务发现 #

必须确保在onConnectionStateChange回调收到BluetoothGatt.STATE_CONNECTED状态后，再调用gatt.discoverServices()，避免提前或重复调用。

示例代码：

// Java示例
@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
    if (newState == BluetoothGatt.STATE_CONNECTED) {
        // 连接成功，立即触发服务发现
        boolean discoverSuccess = gatt.discoverServices();
        Log.d("BLE", "发起服务发现：" + discoverSuccess);
    } else if (newState == BluetoothGatt.STATE_DISCONNECTED) {
        // 处理断开连接逻辑
        gatt.close();
    }
}

3. 保证所有GATT操作在同一线程执行 #

BluetoothGatt实例是线程绑定的，若在不同线程调用connect()、discoverServices()等方法，会导致回调无法正常触发。建议将所有BLE操作放到主线程，或使用固定的Handler线程处理：

// Kotlin示例，使用主线程Handler处理GATT操作
private val mainHandler = Handler(Looper.getMainLooper())

fun connectToDevice(device: BluetoothDevice) {
    mainHandler.post {
        val gatt = device.connectGatt(context, false, gattCallback)
    }
}

// 在gattCallback的onConnectionStateChange中
override fun onConnectionStateChange(gatt: BluetoothGatt?, status: Int, newState: Int) {
    if (newState == BluetoothGatt.STATE_CONNECTED) {
        mainHandler.post {
            gatt?.discoverServices()
        }
    }
}

4. 检查设备端是否需要配对或初始化指令 #

部分BLE设备需要先配对，或发送特定初始化指令（如写入某个特征值）才会广播服务。可以用第三方BLE调试工具测试：

• 用工具连接设备，查看是否能正常发现服务
• 如果工具也无法发现服务，说明是设备端配置问题，需联系设备开发者确认
• 如果工具能发现服务，对比工具的操作流程（如是否配对、是否发送初始化指令），调整APP代码

5. 正确管理BluetoothGatt实例 #

避免重复创建BluetoothGatt实例，每次断开连接后必须调用gatt.close()释放资源，否则会导致系统BLE资源泄漏，影响后续操作：

@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
    if (newState == BluetoothGatt.STATE_DISCONNECTED) {
        gatt.close();
        this.mBluetoothGatt = null;
    }
}

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