Android 12后台WiFi扫描失效问题求助（Pixel 6a）

问题描述 #

我正在重写一款用于室内定位的WiFi信号采集旧应用，要求后台运行或屏幕熄灭时仍能正常工作。前台运行时WiFi扫描功能正常，每4秒可稳定获取扫描结果，但切换至后台或熄屏后出现以下问题：

• WifiManager.StartScan 返回false
• BroadcastReceiver的OnReceive方法不再触发
• WifiManager.ScanResults为空，无旧结果留存

切换回前台或解锁设备后，所有功能恢复正常。测试设备为运行Android 12的Pixel 6a。

已尝试的无效方案 #

• 以带持久通知的Foreground Service运行
• 获取唤醒锁（wake lock）和WiFi锁（wifi lock）
• 禁用设备所有自适应电池功能
• 将应用电池使用设置为“不受限制”
• 禁用设备Wi-Fi scan throttling
• 通过adb禁用设备Doze模式
• 清单文件已配置、应用已请求并获得所有必要权限
• 确认Foreground Service仍在运行

目前不确定是操作有误、遗漏配置，还是遇到了Android对WiFi扫描的不可逾越限制。

排查与解决建议 #

1. 定位权限的后台授权检查 #

Android 12+对后台定位权限有强制要求：

• 必须申请ACCESS_BACKGROUND_LOCATION权限，且用户需授予始终允许的定位权限（仅“使用期间允许”无法支持后台WiFi扫描）。
• 确认清单文件中已声明ACCESS_FINE_LOCATION、ACCESS_COARSE_LOCATION、ACCESS_BACKGROUND_LOCATION、CHANGE_WIFI_STATE、ACCESS_WIFI_STATE这些核心权限，且运行时权限申请流程正确。

2. Foreground Service类型匹配 #

Android 12要求Foreground Service必须指定对应功能类型，针对WiFi定位场景：

• 启动Service时，调用startForeground()需传入ServiceInfo.FOREGROUND_SERVICE_TYPE_LOCATION类型参数，否则系统会限制后台定位相关操作。
• 前台通知的内容需明确标注应用正在进行定位/WiFi扫描操作，避免系统误判为无关后台任务。

3. 系统日志排查限制原因 #

通过adb抓取系统日志，查看是否有WiFi扫描被限制的提示：

adb logcat | grep -i "wifi\|scan\|throttle"

如果日志中出现WifiScanner: Scan throttled或Background scan not allowed等信息，说明系统确实在后台限制了扫描操作，这时候需要调整扫描策略。

4. 扫描策略调整 #

Android 10+后startScan()的后台限制逐渐收紧，可尝试替代方案：

• 使用WorkManager或JobScheduler触发扫描，但需注意Android 12对后台作业的执行频率限制（默认无法达到4秒一次的高频需求），可尝试申请REQUEST_IGNORE_BATTERY_OPTIMIZATIONS权限来提升作业优先级。
• 改用被动监听：注册NETWORK_STATE_CHANGED_ACTION广播，监听WiFi网络状态变化，虽然无法主动触发扫描，但可获取设备自动扫描的结果。

5. 唤醒锁与WiFi锁的正确配置 #

• 唤醒锁需使用PowerManager.PARTIAL_WAKE_LOCK，确保CPU不进入休眠，但注意这无法突破系统对WiFi扫描的后台限制。
• WiFi锁使用WifiManager.WIFI_MODE_FULL_HIGH_PERF，强制WiFi保持高性能模式，避免系统在后台降低WiFi功耗。

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