
你会让你的 MacBook 休眠吗?你知道它其实并没有完全休眠,而是实际上睁着一只眼吗?这是真的,而且它有个名字:DarkWake。
DarkWake 是 macOS 的一项功能:当电脑合上盖子、你实际上已经让它休眠时,它从技术上讲每小时会“睁开眼睛”大约 45 秒。如果你有按计划运行的任务(备份、扫描、报告),一次错过的运行可能就会在这个窗口里被触发,不管你是不是有意为之。你可以用 pmset -g log | grep DarkWake 查看你自己的唤醒窗口,即使关闭了 Power Nap,它们也会出现。
有时候这挺不错,但在我的情况里,它导致我花了多天去追查问题的根本原因。
问题
我的系统里有一些标志,用来在出现失败时提醒我,而它们一直在触发,并且持续了好几天。Claude Code 和我一起深入排查,但我们表面上发现的情况并不是全貌。
当时我大约有 18 个计划任务。有一次运行从 10 月 8 日开始,却从未完成。它在接下来的 3 小时里不断停止又恢复,而其中一个浏览器操作每次都因超时而失败。从表面上看,这像是代码里一个明显的 bug。
然而,这个任务是在显示器关闭、处于“仅维护”的 DarkWake 期间尝试运行的。当这个任务本身的持续时间超过了 45 秒的窗口,并在电脑重新休眠时卡住,然后一小时后再次唤醒时面对的是过期的连接和大量超时,这就成了问题。
第一个修复
在进一步挖掘并了解了 DarkWake 之后,解决方案似乎很简单:在那个窗口里什么都不启动,只在显示器开启时(也就是有人在 Mac 前,也就是我)才启动。我们实现了一个小的守卫脚本,放在这 18 个任务前面,检查显示器的电源状态。如果显示器关闭,它就记录一次跳过。另一个每 2 分钟运行一次的任务会检查显示器是否开启,并重新运行日志中被跳过的任务。
我们用模拟场景测试了这个方案,它通过了。
第二个问题
第二天早上我回到 Mac 前时,隔夜检查显示每个受守卫保护的任务都被跳过了,但我们注意到了另一个问题:日志里每个任务都出现了数百次跳过。有什么东西在循环重启这些任务。我们立刻想到 launchd 是罪魁祸首。也许它会在任务退出得太快时重启它们?
但那是错的。真正的原因是我们写的另一个常驻任务,叫做 network-watch。它的目的是在互联网恢复后重试失败或错过的检查,所以它本应等待连接发生变化。但那条命令实际上并没有等待,于是这个任务大约每 10 秒就重试一次,这就不断重启了守卫正在跳过的那些任务。
修复方法是让 network-watch 也只在显示器开启时才行动,并停止它反反复复地重试。现在它只在连接真正发生变化时才重试,或者作为后备每 5 分钟重试一次。
两个教训
教训 1:计划任务和一台你放任其休眠的电脑,开箱即用时并不能很好地配合。要事先决定好没人在场、盖子合上时应该发生什么。
教训 2:修复之后出现新症状,并不意味着修复失败了。有时候它只是把你引向下一个 bug。