如何防止你的Android应用因唤醒锁而耗电
内容提要
Android唤醒锁用于屏幕关闭时保持CPU运行，但常因异常、提前返回、回调未触发或引用计数失衡而泄漏，导致耗电甚至影响Play商店排名。应始终设置超时、在finally中释放、为每个任务单独加锁，并优先使用WorkManager等自动管理唤醒锁的API。可用dumpsys、batterystats和Lint检测泄漏。
延伸解读
唤醒锁泄漏的根源：控制流问题
文章指出，大多数唤醒锁泄漏并非源于对API的误解，而是常见的控制流问题：在acquire()和release()之间抛出异常、提前返回、回调未触发或引用计数失衡。这些问题在代码审查中难以发现，在正常测试中也不可见，因为设备通常插着电源且屏幕亮着。因此，开发者需要特别关注这些控制流路径，确保在所有情况下都能正确释放锁。
引用计数机制的双面性
唤醒锁默认使用引用计数，每次acquire()增加计数，release()减少计数，只有计数归零时锁才真正释放。这允许多个组件共享同一个锁，但也容易因acquire和release次数不匹配而导致泄漏。文章建议，如果共享锁，可以关闭引用计数（setReferenceCounted(false)）或确保只有一个所有者管理锁，以避免计数漂移。
优先使用自动管理唤醒锁的API
文章强调，在大多数情况下，应避免手动使用唤醒锁，转而使用WorkManager、JobScheduler、goAsync()、前台服务或FLAG_KEEP_SCREEN_ON等高级API。这些API会在工作完成或超时时自动释放锁，从而消除泄漏风险。例如，WorkManager在doWork()期间持有唤醒锁，并在返回结果后释放，无需手动管理。
检测与预防：工具与最佳实践
为了检测唤醒锁泄漏，可以使用dumpsys power查看当前持有的锁，batterystats测量累计持有时间，或通过Battery Historian和Perfetto可视化时间线。此外，Android Lint的Wakelock和WakelockTimeout检查可以静态捕获简单泄漏，而单元测试（如使用Robolectric）可以验证异常路径下锁是否释放。最佳实践包括始终设置超时、在finally块中释放锁、为每个任务使用独立的锁，并利用Play Console的Android Vitals监控过度使用。
Q&A
Android中的唤醒锁是什么？它有什么作用？
唤醒锁是应用向PowerManagerService发出的请求，用于在屏幕关闭时保持CPU运行。它通过Binder调用acquire()获取，系统会记录请求的UID、标签和锁类型，并聚合所有应用请求持有一个内核唤醒源，从而阻止系统进入低功耗挂起状态。
为什么我的Android应用会因唤醒锁泄漏而耗电？
唤醒锁泄漏通常由控制流问题引起，例如在acquire()和release()之间抛出异常、提前返回、回调未触发或引用计数失衡。这些情况下锁未被释放，导致CPU持续运行，消耗电量。
如何正确获取和释放Android唤醒锁以避免泄漏？
应始终为acquire()设置超时，并在finally块中释放锁，确保异常或提前返回时也能释放。推荐使用辅助函数如withLock，它自动处理超时和释放。此外，为每个任务使用单独的锁并设置描述性标签。
有哪些工具可以检测Android应用中的唤醒锁泄漏？
可以使用adb shell dumpsys power查看当前持有的唤醒锁，dumpsys batterystats统计唤醒锁总时间，Battery Historian或Perfetto可视化时间线，以及Android Lint的Wakelock和WakelockTimeout检查。Play Console的Android Vitals也会报告过度唤醒锁使用。
在哪些情况下不需要手动使用唤醒锁？
对于可延迟的后台工作（如同步、上传），应使用WorkManager或JobScheduler；需要精确时间的工作使用AlarmManager；广播后的短时工作使用goAsync()；用户可感知的长时工作（如音乐播放）使用前台服务；保持屏幕常亮使用FLAG_KEEP_SCREEN_ON。这些API会自动管理唤醒锁。
如何测试Android应用中的唤醒锁行为？
可以使用Robolectric进行单元测试，通过ShadowPowerManager获取最新的唤醒锁，并断言在失败路径后锁未被持有。注入WakeLock或包装接口可以更方便地使用假实现进行测试。
