WiFi扫描广播接收器仅注册一次却持续返回结果的问题排查

问题场景与代码 #

这是我从WiFiManager文档中获取的广播接收器代码：

private val wifiScanReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent?) {
        val success = intent?.getBooleanExtra(WifiManager.EXTRA_RESULTS_UPDATED, false) ?: false
        Log.d("WifiManager", "In on receive $success with scan number: $scanId")

        if (success) {
            scanSuccess()
        } else {
            scanFailure()
        }
        // unregisterWifiReceiver()
    }
}

我在onCreate方法中注册该WiFi接收器，每次点击按钮时调用startScan。但即使只点击一次按钮，也会持续收到扫描结果，这导致我向数据库存储数据时出现重复项，不过有时level值会有所不同。

我目前找到的解决方法是扫描成功后立即注销WiFi接收器，每次点击按钮时重新创建接收器。但我不确定是否需要存储所有这些值——level值为何会波动？为何会返回这么多结果？我正将其用于WiFi指纹识别，因此level值十分重要。

问题原因分析 #

1. 重复收到扫描结果的原因 #

Android系统中，WifiManager.startScan()并非只触发一次扫描回调：

• 部分设备会在调用startScan()后，自动启动系统层面的周期性扫描，以维持WiFi连接的稳定性
• 部分WiFi驱动会在检测到信号波动时，主动触发重新扫描，导致接收器持续收到广播
• 若在onCreate中持续注册接收器，所有系统触发的扫描完成广播都会被捕获，即便你只手动调用了一次startScan

2. level值波动的原因 #

WiFi信号强度（level，单位dBm）本身就是动态变化的，核心原因包括：

• 多径效应：WiFi信号通过反射、折射等多种路径到达设备，不同路径的信号叠加会导致强度波动
• 环境干扰：周围其他WiFi设备、蓝牙设备、微波炉等电器会产生电磁干扰，影响信号接收精度
• 微小位置变化：设备移动几厘米、角度微调，都会改变信号接收的距离和角度，引发强度变化
• 硬件状态波动：WiFi模块的供电变化、临时负载波动，也会影响信号检测的稳定性

针对WiFi指纹识别的解决方案 #

1. 精准控制扫描回调次数 #

你的临时方案（扫描成功后注销接收器，每次点击重新注册）是可行的，可优化得更严谨：

• 调用startScan()前检查接收器注册状态，避免重复注册引发异常
• 不要立即注销接收器，可设置采样次数阈值（比如收集3-5次扫描结果），达到阈值后再注销，确保获取足够样本
• 若不需要连续采样，可在scanSuccess()执行完成后延迟1-2秒注销，规避系统延迟触发的额外扫描

2. 信号值的处理策略 #

对于WiFi指纹识别，不需要存储所有波动的level值，更合理的做法是：

• 收集同一AP的多次采样值，计算平均值、中位数，或去掉极值后的平均值，用这个稳定值作为指纹数据
• 设定异常值过滤规则，比如过滤掉与平均值偏差超过10dBm的采样值，避免极端值干扰
• 同一位置多次扫描，合并多个扫描结果中的AP信息，确保指纹数据的完整性

代码优化示例 #

可以修改接收器逻辑，加入采样计数与数据处理：

private val MAX_SAMPLES = 5 // 设定需要收集的采样次数
private var sampleCount = 0
private val signalSamples = mutableMapOf<String, MutableList<Int>>() // 存储SSID对应的信号强度列表

private val wifiScanReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent?) {
        val success = intent?.getBooleanExtra(WifiManager.EXTRA_RESULTS_UPDATED, false) ?: false
        if (!success) {
            scanFailure()
            return
        }

        val wifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager
        val scanResults = wifiManager.scanResults
        scanResults.forEach { result ->
            val ssid = result.SSID
            val level = result.level
            signalSamples.getOrPut(ssid) { mutableListOf() }.add(level)
        }

        sampleCount++
        if (sampleCount >= MAX_SAMPLES) {
            processStableFingerprints()
            unregisterWifiReceiver()
            // 重置计数与样本
            sampleCount = 0
            signalSamples.clear()
        }
    }
}

private fun processStableFingerprints() {
    val stableFingerprints = mutableMapOf<String, Int>()
    signalSamples.forEach { (ssid, levels) ->
        // 去掉最小和最大的极值，取剩余值的平均值
        val sortedLevels = levels.sorted()
        val filteredLevels = sortedLevels.drop(1).dropLast(1)
        val averageLevel = filteredLevels.average().toInt()
        stableFingerprints[ssid] = averageLevel
    }
    // 将stableFingerprints存入数据库用于指纹识别
}

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