Android BLE库setManufacturerData()过滤失效：非匹配厂商数据被放行

问题原因 #

你遇到的不是Android BLE库的bug，而是对setManufacturerData方法的匹配逻辑理解有误：当调用不带掩码的重载方法时，系统默认采用前缀匹配规则——只要广播的厂商数据前缀包含你设置的字节数组，就会被过滤通过。比如你设置了0x0A,0x0A，广播的0x0A,0x0B（前缀第一个字节匹配）、0x0A,0x0A,0x0C（前缀完全匹配）都会被放行，这是设计默认行为。

解决方案 #

要实现完全字节匹配，必须使用带掩码的setManufacturerData重载方法，通过掩码指定每个字节的匹配规则：

1. 使用带掩码的过滤配置 #

给每个需要匹配的字节设置掩码0xFF（表示该字节必须完全一致），示例代码：

// 目标厂商ID（替换为你的实际厂商ID）
private static final int MY_MANUFACTURER_ID = 0x1234;
// 需要完全匹配的厂商数据
byte[] targetManufacturerData = new byte[]{0x0A, 0x0A};
// 掩码：每个字节都要求完全匹配
byte[] dataMask = new byte[]{(byte) 0xFF, (byte) 0xFF};

ScanFilter.Builder filterBuilder = new ScanFilter.Builder();
filterBuilder.setManufacturerData(MY_MANUFACTURER_ID, targetManufacturerData, dataMask);

2. 兼容旧版本系统的二次过滤 #

部分Android 8.0以下版本的BLE过滤存在系统层面的兼容性问题，即使配置了掩码仍可能出现漏网情况。此时建议在扫描回调中手动校验厂商数据：

@Override
public void onScanResult(int callbackType, ScanResult result) {
    ScanRecord record = result.getScanRecord();
    if (record == null) return;

    // 获取广播中的厂商数据
    Map<Integer, byte[]> manufacturerDataMap = record.getManufacturerSpecificData();
    byte[] receivedData = manufacturerDataMap.get(MY_MANUFACTURER_ID);
    if (receivedData == null) return;

    // 手动校验是否完全匹配
    if (Arrays.equals(receivedData, targetManufacturerData)) {
        // 处理符合条件的设备
        processDevice(result);
    }
}

开发者常见问题反馈 #

这个问题在开发者社区非常普遍，大多是因为忽略了掩码的作用，误将前缀匹配当成了完全匹配。只要正确配置掩码，就能解决绝大多数匹配失效的情况。

内容的提问来源于stack exchange，提问作者Manu Ram V