原生移动开发 / 系统课时

排查 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])

WakeLock 持有与释放排查路径

从申请点反查释放点

先搜索项目中的 newWakeLock(、acquire( 和 release(。重点不是简单统计数量,而是确认每一次业务路径是否都能走到释放逻辑。WakeLock 默认采用引用计数,因此多次 acquire() 时需要对应次数的 release();也可以通过 isHeld() 判断当前是否仍持有。([Android Developers][3])

典型风险包括异常直接返回、协程取消、回调未执行、多个分支共用一个锁,以及把锁对象放在生命周期过长的单例中。对于一次性后台任务,申请与释放最好紧挨着,并把释放放进 finally。

kotlin
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])

用系统证据缩小范围

可先抓取电池统计信息,再结合最近发生异常的业务操作分析持锁时间。命令本身不要求应用处于前台,因此适合复现“锁屏后仍持续耗电”的问题。

bash
adb shell dumpsys batterystats

预期输出:终端返回设备电池统计信息,其中包含应用及其 WakeLock 活跃记录;实际字段和详细内容会随 Android 版本及设备实现而变化。([Android Developers][2])

拿到证据后继续回到代码定位:如果系统记录显示某个标签长时间活跃,就按标签搜索创建位置,再沿调用链确认谁调用了 acquire()、谁应该负责 release()。不要只在发现异常的地方补一个 release(),还要检查取消、异常和重复进入路径。

常见错误与修复边界

最常见的错误是把 WakeLock 当成“后台任务许可证”。它只解决设备是否保持唤醒这一件事,并不会自动保证任务可靠执行。对于能由更高层后台任务 API 管理的工作,应优先减少直接持有 WakeLock 的范围,而不是把锁的持有时间继续拉长。

另一个隐蔽问题是为了“保险”永久持锁。真正的保险措施应是短持有 + 明确释放 + 超时兜底。如果任务本身不需要保持 CPU 活跃,就不应该通过 WakeLock 强行维持运行;否则待机耗电问题只是被延后,而不是被解决。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查 WakeLock 长时间持有

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通