原生移动开发 / 系统课时
排查 WakeLock 长时间持有
排查 WakeLock 长时间持有
本篇解决后台耗电却看不出明显 CPU 工作的典型问题:应用持有 WakeLock 后没有及时释放,导致设备无法充分进入低功耗状态。你将从持有证据入手,再沿申请、使用、释放三条路径定位异常。
学习目标
- 能用系统诊断信息确认应用是否长期持有 WakeLock
- 能检查 acquire 与 release 是否成对,并识别异常持锁路径
- 能用超时和 finally 等方式降低遗漏释放的风险
先确认是不是 WakeLock 问题
PARTIAL_WAKE_LOCK 的作用是让 CPU 在屏幕关闭后仍保持运行。它本身不是错误,问题在于任务完成后仍然长期持有;这会阻止设备进入更低功耗状态,从而增加待机耗电。Android 官方也建议只有确有必要时使用,并尽快释放。([Android Developers][1])
定位时不要先改代码,先建立证据。Android 官方建议使用 adb shell dumpsys batterystats 查看应用持有 WakeLock 的历史记录;Android Studio 的 Background Task Inspector 也可以观察 WakeLock、alarm 和 job。([Android Developers][2])

从申请点反查释放点
先搜索项目中的 newWakeLock(、acquire( 和 release(。重点不是简单统计数量,而是确认每一次业务路径是否都能走到释放逻辑。WakeLock 默认采用引用计数,因此多次 acquire() 时需要对应次数的 release();也可以通过 isHeld() 判断当前是否仍持有。([Android Developers][3])
典型风险包括异常直接返回、协程取消、回调未执行、多个分支共用一个锁,以及把锁对象放在生命周期过长的单例中。对于一次性后台任务,申请与释放最好紧挨着,并把释放放进 finally。
import android.os.PowerManager
fun runCriticalWork(powerManager: PowerManager) {
val wakeLock = powerManager.newWakeLock(
PowerManager.PARTIAL_WAKE_LOCK,
"App:CriticalWork"
)
wakeLock.apply {
try {
// 超时是最后一道保护,业务完成后仍应主动释放
acquire(30_000L)
doCriticalWork()
} finally {
if (isHeld) {
release()
}
}
}
}
private fun doCriticalWork() {
// 执行必须保持 CPU 活跃的短任务
}预期结果:任务正常完成时执行 release();任务抛出异常时仍会进入 finally 释放;如果代码存在漏释放问题,超时参数会在指定时长后自动释放 WakeLock。acquire(long) 会在超时后自动释放,isHeld() 可用于确认当前状态。([Android Developers][3])
用系统证据缩小范围
可先抓取电池统计信息,再结合最近发生异常的业务操作分析持锁时间。命令本身不要求应用处于前台,因此适合复现“锁屏后仍持续耗电”的问题。
adb shell dumpsys batterystats预期输出:终端返回设备电池统计信息,其中包含应用及其 WakeLock 活跃记录;实际字段和详细内容会随 Android 版本及设备实现而变化。([Android Developers][2])
拿到证据后继续回到代码定位:如果系统记录显示某个标签长时间活跃,就按标签搜索创建位置,再沿调用链确认谁调用了 acquire()、谁应该负责 release()。不要只在发现异常的地方补一个 release(),还要检查取消、异常和重复进入路径。
常见错误与修复边界
最常见的错误是把 WakeLock 当成“后台任务许可证”。它只解决设备是否保持唤醒这一件事,并不会自动保证任务可靠执行。对于能由更高层后台任务 API 管理的工作,应优先减少直接持有 WakeLock 的范围,而不是把锁的持有时间继续拉长。
另一个隐蔽问题是为了“保险”永久持锁。真正的保险措施应是短持有 + 明确释放 + 超时兜底。如果任务本身不需要保持 CPU 活跃,就不应该通过 WakeLock 强行维持运行;否则待机耗电问题只是被延后,而不是被解决。