如何在Crontab调度的Python主脚本中运行一次性子定时任务

你当前的子任务无法触发，核心原因是schedule库的任务注册后，必须持续运行schedule.run_pending()的轮询逻辑才能触发，而你通过crontab调用的主脚本在注册完schedule任务后就直接退出了，没有保持进程运行，注册的定时任务自然不会被执行。
另外你用schedule.every().day.at("5:30")搭配return schedule.CancelJob的配置本身是可以实现单次执行的，但前提是schedule的轮询进程一直存活到5:30。

放弃在主脚本内用schedule做跨小时的定时，直接用系统自带的at命令实现一次性定时任务，不需要主进程长期挂起，稳定性更高：

1. 先确认系统安装了at工具并开启atd服务：
   • Debian/Ubuntu执行：apt install at && systemctl enable --now atd
   • CentOS/RHEL执行：yum install at && systemctl enable --now atd
2. 修改主脚本逻辑，满足日期条件时直接注册一次性at任务，注意所有路径用绝对路径：

import datetime
import subprocess

# 替换为你sub_file.py的实际绝对路径
SUB_FILE_PATH = "/opt/your_project/sub_file.py"
# 替换为你实际python3的绝对路径，可以用which python3查看
PYTHON_PATH = "/usr/bin/python3"

if today == "你指定的日期":
    # 注册5:30的一次性定时任务，同时配置日志输出
    cmd = f'echo "{PYTHON_PATH} {SUB_FILE_PATH} >> /var/log/sub_task.log 2>&1" | at 05:30'
    subprocess.run(cmd, shell=True, check=True)

需要在主脚本末尾增加轮询逻辑，让主进程保持运行直到任务执行完成，不推荐该方案：主进程需要挂起4小时，容易因系统重启、进程被回收等原因丢失任务。
修改后的主脚本示例：

import datetime
import time
import schedule

if today == "你指定的日期":
    def run1():
        exec(open('绝对路径/sub_file.py').read())
        return schedule.CancelJob
    schedule.every().day.at("5:30").do(run1)              

    # 新增轮询逻辑
    while True:
        schedule.run_pending()
        # 超过6点自动退出，避免进程无限挂起
        if datetime.datetime.now().hour >= 6:
            break
        # 每分钟检查一次即可，减少资源占用
        time.sleep(60)

为了避免子任务重复执行、多实例冲突，可以加文件锁机制：
在子任务开头新增fcntl文件锁逻辑，进程崩溃后锁会自动释放，不会出现残留死锁：

import fcntl
import sys

lock_file = open("/tmp/sub_task.lock", "w")
try:
    # 非阻塞加锁，加锁失败说明已有任务在运行，直接退出
    fcntl.flock(lock_file, fcntl.LOCK_EX | fcntl.LOCK_NB)
except BlockingIOError:
    sys.exit(0)

# 后面是你原来的子任务逻辑

• 所有脚本、命令的路径必须用绝对路径，crontab和at的环境变量PATH都不全，用相对路径会出现文件找不到的问题
• 所有定时任务都加上日志重定向，方便后续排查问题
• 尽量不要用exec执行另一个脚本的内容，改用subprocess调用python执行子脚本，可控性和安全性更高：subprocess.run([PYTHON_PATH, SUB_FILE_PATH], check=True)

内容的提问来源于stack exchange，提问作者Ashin