MAUI应用Android端BLE扫描无设备排查求助

以下是可能被遗漏的关键检查点及解决方法：

• Android版本对应的权限细节
  Android不同版本对BLE权限的要求差异很大，别只盯着基础权限：

  • Android 10及以下：必须申请ACCESS_COARSE_LOCATION或ACCESS_FINE_LOCATION，哪怕你的BLE扫描不依赖位置信息，系统也强制要求
  • Android 11：同低版本，后台扫描额外需要ACCESS_BACKGROUND_LOCATION
  • Android 12+：需申请BLUETOOTH_SCAN和BLUETOOTH_CONNECT权限；如果不需要通过BLE获取位置，要在AndroidManifest.xml中给BLUETOOTH_SCAN添加android:usesPermissionFlags="neverForLocation"属性，否则仍需位置权限。动态申请时要根据系统版本判断，针对性申请对应权限。

• 确认BLE适配器状态
  别默认认为蓝牙是开启的，代码里必须检查adapter.IsBluetoothEnabled状态：

  • 如果蓝牙未开启，要引导用户跳转系统设置打开蓝牙，或通过MAUI的API触发开启请求。很多设备默认蓝牙关闭，权限到位但蓝牙没开，自然扫不到设备。

• 检查扫描过滤器是否过于严格
  如果你给扫描设置了特定UUID、设备名称等过滤器，可能因条件太严匹配不到设备。先移除过滤器，执行全量扫描（比如把adapter.StartScan(filters)改成adapter.StartScan()），验证是否能发现设备，排除过滤规则的问题。

• 后台扫描的限制
  Android对后台BLE扫描有严格限制：

  • Android 10+后台扫描需要ACCESS_BACKGROUND_LOCATION权限，且扫描频率会被系统限制
  • 测试时先切换到前台扫描，确认前台能扫到后再处理后台扫描的权限和逻辑

• 排除设备本身的广播问题
  用第三方BLE工具（比如nRF Connect）在同一Android设备上扫描，看是否能发现目标设备。如果工具也扫不到，说明是BLE设备未广播或处于休眠状态，和应用无关。

• 事件注册时机是否正确
  必须在调用StartScan之前注册DeviceDiscovered事件，否则会错过扫描开始后发现的设备。正确顺序示例：

  adapter.DeviceDiscovered += OnDeviceDiscovered;
  await adapter.StartScanAsync();
  

• 第三方BLE库的兼容性
  如果你使用的是第三方BLE库（如Plugin.BLE），检查库版本是否适配当前MAUI版本，有没有已知的Android兼容bug。尝试更新到最新稳定版，同时确认库的初始化代码是否正确（比如Android端是否传入了正确的上下文）。

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