Ubuntu虚拟机通过Cron Job定时运行Python脚本失败求解决方案

• 执行环境差异：cron运行时的环境变量与用户交互式shell的环境变量不同，默认不会加载用户终端的PATH配置、conda环境变量等，这是绝大多数cron执行Python任务失败的核心原因。
• 写法1问题：直接执行.py文件，既没有给文件配置可执行权限，也没有在.py文件头部声明正确的Python解释器shebang（如#!/home/try/miniconda3/bin/python），系统无法识别文件的执行方式。
• 写法3问题：直接调用python命令，cron默认PATH中没有包含miniconda的二进制文件路径，无法找到对应的Python解释器，直接执行失败。
• 写法4问题：虽然指定了Python解释器的绝对路径，但.py文件使用了相对路径，cron默认工作目录为当前用户的家目录，若文件不在对应路径、或者代码中依赖相对路径读取其他资源，就会出现文件找不到的报错。
• 写法2问题：路径都为绝对路径但仍失败，通常是两个原因：一是Python代码中依赖相对路径读写其他文件，cron工作目录不匹配导致资源读取失败；二是代码依赖miniconda特定虚拟环境中的第三方库，直接调用base环境的Python解释器无法加载对应依赖。

前置检查 #

1. 先手动执行命令验证可正常运行：/home/try/miniconda3/bin/python /home/try/myf.py，确认没有报错后再配置cron。
2. 给.py文件赋予读权限：chmod +r /home/try/myf.py

场景1：代码无相对路径依赖资源 #

直接指定解释器和脚本的绝对路径，同时添加日志重定向方便排查问题：

0 14 * * * /home/try/miniconda3/bin/python /home/try/myf.py >> /home/try/cron_py.log 2>&1

末尾的>> /home/try/cron_py.log 2>&1会将脚本的标准输出、错误输出都追加写入到指定的日志文件中。

场景2：代码依赖同目录下的相对路径资源 #

先切换到脚本所在目录再执行：

0 14 * * * cd /home/try && /home/try/miniconda3/bin/python myf.py >> /home/try/cron_py.log 2>&1

场景3：代码运行在miniconda的自定义虚拟环境中 #

使用conda run命令激活对应环境后执行，避免cron中source激活环境的兼容性问题：

0 14 * * * cd /home/try && /home/try/miniconda3/bin/conda run -n 你的虚拟环境名称 python myf.py >> /home/try/cron_py.log 2>&1

• 查看系统默认cron日志：Ubuntu默认将cron运行记录存储在syslog中，执行以下命令过滤cron相关记录：
  grep CRON /var/log/syslog
  该日志可以查看cron是否触发了任务、任务执行的用户、命令调用是否出错等基础信息。
• 开启独立cron日志（可选）：编辑/etc/rsyslog.d/50-default.conf文件，将#cron.* /var/log/cron.log行首的注释符#删除，随后执行sudo systemctl restart rsyslog cron重启服务，之后所有cron日志会单独写入/var/log/cron.log文件。
• 查看脚本自定义日志：上述配置中添加的重定向日志/home/try/cron_py.log会记录Python脚本自身的所有输出和报错，是排查代码层面问题的主要依据。

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