macOS下Python定时脚本频繁跳过执行间隔的原因与解决咨询

你的问题确实是macOS睡眠模式导致的——当系统进入睡眠状态时，所有用户进程都会被挂起，暂停执行，直到系统被唤醒。不管你用schedule库、time.sleep还是threading.Timer，都会因为进程被暂停而出现时间跳变，这是系统级的限制，和脚本实现无关。

针对这个问题，有几种不同的解决思路，根据你的需求选择：

1. 临时禁用系统睡眠（快速测试用） #

使用macOS自带的caffeinate命令，它可以阻止系统进入睡眠状态，保证脚本持续运行：

• 运行脚本时加上该命令：

  caffeinate -i python scheduling.py &
  

  参数说明：
  • -i：防止系统因空闲进入睡眠
  • -s：防止显示器进入睡眠（如果需要保持屏幕常亮）
  • -u：防止系统因用户闲置进入睡眠
• 也可以通过系统设置全局禁用睡眠：打开「系统设置」→「显示器」→「高级」，勾选「防止自动睡眠当显示器关闭时」，但这会影响设备续航，适合桌面端使用。

2. 使用macOS原生launchd定时任务（推荐，长期运行） #

launchd是macOS系统级的任务调度工具，比用户级脚本更可靠：即使系统睡眠后唤醒，它会自动处理错过的任务，并且不受用户进程挂起的影响。

步骤： #

1. 创建一个plist配置文件，比如com.user.schedulingtimer.plist，放在~/Library/LaunchAgents/目录下：

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
       <key>Label</key>
       <string>com.user.schedulingtimer</string> <!-- 唯一标识，不能重复 -->
       <key>ProgramArguments</key>
       <array>
           <string>/usr/bin/python3</string> <!-- 你的Python路径，可用`which python3`查看 -->
           <string>/path/to/your/scheduling.py</string> <!-- 脚本的绝对路径 -->
       </array>
       <key>StartInterval</key>
       <integer>10</integer> <!-- 执行间隔，单位秒 -->
       <key>RunAtLoad</key>
       <true/> <!-- 加载配置时立即执行一次 -->
       <key>StandardOutPath</key>
       <string>/path/to/your/scheduling.log</string> <!-- 日志输出路径 -->
       <key>StandardErrorPath</key>
       <string>/path/to/your/error.log</string> <!-- 错误日志路径 -->
       <key>KeepAlive</key>
       <false/> <!-- 定时任务不需要保持进程存活 -->
   </dict>
   </plist>
   

2. 加载配置文件：

   launchctl load ~/Library/LaunchAgents/com.user.schedulingtimer.plist
   

3. 若需要停止任务：

   launchctl unload ~/Library/LaunchAgents/com.user.schedulingtimer.plist
   

注意：如果脚本需要在指定时间（END变量）后停止，可以在脚本内保留时间判断逻辑，到点自动退出即可，launchd下次就不会再执行该任务。

3. 脚本层面的时间补偿机制（允许系统睡眠时使用） #

如果你必须允许系统进入睡眠，可以修改脚本逻辑，基于绝对时间计算下次执行点，避免依赖累计的sleep时间：

修改后的脚本示例：

import datetime
import time
import logging

logging.basicConfig(filename='scheduling.log',
                    format='%(levelname)s: %(message)s',
                    encoding='utf-8', level=logging.DEBUG)

PERIOD = 10
END = datetime.datetime(2023, 4, 9, 11, 55, 0)

def log():
    logging.info(str(datetime.datetime.now()))

# 初始化下次执行时间
next_run = datetime.datetime.now()

while datetime.datetime.now() < END:
    now = datetime.datetime.now()
    # 检查是否到了执行时间
    if now >= next_run:
        log()
        # 更新下次执行时间，基于上次计划时间加间隔，避免累计误差
        next_run += datetime.timedelta(seconds=PERIOD)
        # 如果系统睡眠导致错过多次执行，直接跳到最近的下一个执行点
        while next_run < now:
            next_run += datetime.timedelta(seconds=PERIOD)
    # 计算需要睡眠的时间，最多睡眠PERIOD秒，避免长时间阻塞
    sleep_duration = (next_run - now).total_seconds()
    time.sleep(min(sleep_duration, PERIOD))

这种方式的优点是，系统唤醒后脚本会立即检查时间，执行任务并调整后续计划，不会因为睡眠导致后续执行频率混乱，但中间睡眠时段的任务还是会被跳过，无法补执行。

内容的提问来源于stack exchange，提问作者Fabián Abarca Calderón