配置ScanFilter扫描特定BLE设备无返回结果的问题咨询

前期崩溃问题原因 #

你之前遇到的IndexOutOfBoundsException是因为onBatchScanResults回调的results列表可能为空，你没有做合法性校验就直接取下标0导致越界。删除该方法走系统默认实现自然不会触发该异常。

带Filter扫描不到设备的常见原因及修复方案 #

• 扫描配置参数兼容问题
  你当前ScanSettings中设置了setReportDelay(1L)，这个参数代表批量返回扫描结果的等待时长，设为非0值时系统会优先回调onBatchScanResults而非你使用的onScanResult，且部分安卓蓝牙栈对极小的延迟值兼容很差，大概率会吞掉扫描结果。同时你用的SCAN_MODE_LOW_POWER模式扫描占空比极低，很容易漏扫广播包。
  修复建议：将setReportDelay设为0（代表实时返回单条结果到onScanResult），测试阶段先使用SCAN_MODE_LOW_LATENCY模式提升扫描成功率，确认功能正常后再根据功耗需求调整模式。
• 服务UUID匹配逻辑问题
  安卓ScanFilter的setServiceUuid是完全匹配规则，两个常见错误会导致匹配失败：
  1. 你要扫描的外设广播包中未携带对应服务UUID：部分设备仅将服务UUID放在扫描响应包，或者根本不在广播中携带服务UUID，仅用设备名/MAC标识。你可以先在无过滤扫描时，打印所有扫描结果的scanResult.scanRecord?.serviceUuids字段，确认目标设备确实广播了你指定的服务UUID。
  2. UUID格式转换错误：如果目标设备用的是16/32位短UUID，需要按照蓝牙规范补全为128位UUID，比如16位UUID0xFFE0补全后为0000ffe0-0000-1000-8000-00805f9b34fb，补全错误会导致匹配不到。
• 权限适配问题
  如果你的App运行在安卓12及以上系统，带过滤扫描要求必须持有BLUETOOTH_SCAN权限，且不能声明neverForLocation属性（如果需要通过蓝牙获取位置）；安卓11及以下系统需要持有位置权限且位置开关处于开启状态，部分厂商定制系统会拦截权限不全的带过滤扫描请求，反而允许无过滤扫描返回结果，建议先检查权限申请状态。

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