Android BLE扫描：如何触发首次匹配与设备断开的回调函数？

阿华AIGC实验室

2026-5-29

解决Android BLE扫描中首次匹配与设备丢失回调不触发的问题

我之前也踩过BLE扫描回调的坑，结合你的代码和场景，给你梳理几个关键的解决点：

一、核心问题：ScanSettings配置不达标

你尝试了CALLBACK_TYPE_FIRST_MATCH|CALLBACK_TYPE_MATCH_LOST但没生效，大概率是扫描模式、匹配模式的搭配出了问题，系统需要更明确的规则才能触发丢失检测。

修改ScanSettings配置

把你的扫描设置改成这样，重点调整扫描模式、匹配模式、匹配次数这几个参数：

ScanSettings settings = new ScanSettings.Builder()
        // 用低延迟模式，确保更快接收广播包，避免因扫描间隔过大漏检
        .setScanMode(ScanSettings.SCAN_MODE_LOW_LATENCY)
        // 同时启用首次匹配和丢失回调
        .setCallbackType(ScanSettings.CALLBACK_TYPE_FIRST_MATCH | ScanSettings.CALLBACK_TYPE_MATCH_LOST)
        // 激进匹配模式，降低触发丢失回调的阈值
        .setMatchMode(ScanSettings.MATCH_MODE_AGGRESSIVE)
        // 设置为单次广播匹配，更快触发首次匹配回调
        .setNumOfMatches(ScanSettings.MATCH_NUM_ONE_ADVERTISEMENT)
        .build();

二、完善ScanCallback的实现

你的回调只重写了onScanResult，但还需要处理扫描失败的情况，同时明确区分不同回调类型的逻辑：

private ScanCallback leScanCallback = new ScanCallback() {
    @Override
    public void onScanResult(int callbackType, ScanResult result) {
        super.onScanResult(callbackType, result);
        String deviceAddr = result.getDevice().getAddress();
        switch (callbackType) {
            case ScanSettings.CALLBACK_TYPE_FIRST_MATCH:
                Log.d(ACTIVITY_TAG, "✅ 首次匹配到设备: " + deviceAddr);
                break;
            case ScanSettings.CALLBACK_TYPE_MATCH_LOST:
                Log.d(ACTIVITY_TAG, "❌ 设备丢失: " + deviceAddr);
                break;
            default:
                Log.d(ACTIVITY_TAG, String.format("其他回调类型:%d 设备:%s", callbackType, deviceAddr));
        }
    }

    @Override
    public void onScanFailed(int errorCode) {
        super.onScanFailed(errorCode);
        Log.e(ACTIVITY_TAG, "扫描失败，错误码: " + errorCode);
        // 常见错误码：2=无法启动扫描（权限/蓝牙未开），4=扫描超时，可针对性排查
    }
};

三、容易忽略的系统与权限问题

权限检查：
- Android 12+：必须申请BLUETOOTH_SCAN、BLUETOOTH_CONNECT权限，后台扫描还需添加android:usesPermissionFlags="neverForLocation"到BLUETOOTH_SCAN权限中
- Android 11及以下：需要ACCESS_FINE_LOCATION权限，且必须开启系统位置服务（部分机型强制要求）
设备地址类型：
如果你的BLE设备用的是随机蓝牙地址（而非公共地址），setDeviceAddress过滤可能失效，因为随机地址会周期性变化。这种情况建议改用UUID、设备名称等其他过滤条件，比如：
```
ScanFilter filter = new ScanFilter.Builder()
        .setServiceUuid(ParcelUuid.fromString("你的设备UUID"))
        .build();
```
设备广播状态：
先用BLE调试工具确认目标设备正在正常广播，且广播间隔不要过大（建议≤1000ms）——如果设备广播间隔太长，系统需要等待多个周期没收到包才会触发MATCH_LOST，可能会有明显延迟。