Android Kotlin中无法找到已知UUID的BLE服务问题求助

可能的原因及解决方法 #

1. Android 14的BLE扫描过滤限制 #

Android 14对BLE扫描的过滤机制更严格，若扫描时未指定目标服务UUID，系统可能会过滤掉部分非主动广播的服务。电脑端bleak不受此系统限制，因此能检测到加速度计服务。

解决方式：

• 在启动BLE扫描时，添加ScanFilter指定目标服务UUID，而非无过滤扫描：

  val targetServiceUuid = ParcelUuid.fromString("e95d0753-251d-470a-a062-fa1922dfa9a8")
  val scanFilter = ScanFilter.Builder().setServiceUuid(targetServiceUuid).build()
  val scanSettings = ScanSettings.Builder().build()
  bluetoothAdapter.bluetoothLeScanner.startScan(listOf(scanFilter), scanSettings, scanCallback)
  

2. Oppo/一加ColorOS的定制优化 #

ColorOS（一加、OPPO设备的系统）存在BLE后台扫描优化逻辑，可能主动隐藏部分服务或限制后台扫描的服务数量，导致目标服务未被发现。

解决方式：

• 进入设备电池设置，将应用设为无限制后台活动，关闭应用专属省电模式；
• 先在系统蓝牙设置中手动配对BBC Micro:bit，再通过应用连接已配对设备，而非应用内扫描配对。

3. BLE服务发现时机或设备端服务状态问题 #

调用gatt.discoverServices()后，虽触发onServicesDiscovered()，但系统可能未完全同步所有服务；或BBC Micro:bit的加速度计服务为按需启用状态，未主动广播。

解决方式：

• 在onServicesDiscovered()中打印所有已发现服务的UUID，确认目标服务是否真的未被扫描到：

  override fun onServicesDiscovered(gatt: BluetoothGatt?, status: Int) {
      super.onServicesDiscovered(gatt, status)
      gatt?.services?.forEach { service ->
          Log.d("BLE_DEBUG", "已发现服务UUID: ${service.uuid}")
      }
  }
  

• 在连接成功后延迟1-2秒再调用discoverServices()，给设备足够的服务广播同步时间：

  override fun onConnectionStateChange(gatt: BluetoothGatt?, status: Int, newState: Int) {
      super.onConnectionStateChange(gatt, status, newState)
      if (newState == BluetoothProfile.STATE_CONNECTED) {
          Handler(Looper.getMainLooper()).postDelayed({
              gatt?.discoverServices()
          }, 1500)
      }
  }
  

4. 权限声明的细节问题 #

Android 14中BLE权限的声明有版本适配要求，若Manifest声明不正确，可能导致服务扫描受限。

解决方式：

• 检查Manifest中的权限声明，确保适配Android 12+的权限规则：

  <uses-permission android:name="android.permission.BLUETOOTH_SCAN" 
      android:usesPermissionFlags="neverForLocation" 
      android:minSdkVersion="31" />
  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" 
      android:minSdkVersion="31" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" 
      android:maxSdkVersion="30" />
  

• 确认应用已动态申请所有所需权限，且用户已授予。

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