Crontab调度Python脚本失败，如何排查故障原因？

我来帮你一步步定位这个问题——手动执行正常但cron调度失败，大概率是环境差异或者路径问题导致的，咱们逐个排查：

1. 先捕获cron的执行日志/错误信息 #

cron默认不会把执行的错误信息输出到终端，所以第一步要把所有输出重定向到日志文件，方便看哪里出问题。修改你的crontab命令：

45 12 * * * /usr/bin/python /users/myuser/slots_update.py >> /users/myuser/cron_run_log.txt 2>&1

这样所有标准输出和错误都会写入cron_run_log.txt，等任务执行后打开这个文件，就能看到具体的报错（比如找不到模块、文件不存在等）。

2. 检查脚本中的相对路径 #

你的脚本里用了key.json这个相对路径，但cron执行时的工作目录并不是脚本所在的文件夹（默认是用户的主目录，或者/），手动执行时你是在脚本目录下，所以能找到文件，但cron跑的时候会找不到这个JSON密钥文件。

解决方法：把脚本里的key.json改成绝对路径，比如：

creds = ServiceAccountCredentials.from_json_keyfile_name('/users/myuser/key.json', scope)

3. 确认Python环境一致性 #

终端里的python和cron调用的/usr/bin/python可能不是同一个环境：

• 先在终端执行which python，看看你手动用的Python路径（比如可能是/usr/local/bin/python3或者虚拟环境里的路径）
• 如果和cron里的/usr/bin/python不一样，说明两个环境安装的依赖库（gspread、pandas、sqlalchemy等）不一致，cron用的系统Python可能没装这些库。

解决方法：

• 把crontab里的Python路径改成终端输出的路径，比如：

  45 12 * * * /usr/local/bin/python3 /users/myuser/slots_update.py
  

• 或者用虚拟环境的Python路径，比如你创建了venv：

  45 12 * * * /users/myuser/venv/bin/python /users/myuser/slots_update.py
  

4. 检查cron的环境变量 #

cron的环境变量比终端少很多，比如PATH、数据库连接的环境变量（PGUSER、PGPASSWORD、PGHOST等）可能没设置，而你的SQLAlchemy连接字符串postgresql://可能依赖这些环境变量才能正常连接数据库。

解决方法：

• 在crontab里手动设置必要的环境变量，比如：

  45 12 * * * PGUSER=your_username PGPASSWORD=your_password /usr/bin/python /users/myuser/slots_update.py
  

• 或者在脚本开头添加环境变量的设置，比如：

  import os
  os.environ['PGUSER'] = 'your_username'
  os.environ['PGPASSWORD'] = 'your_password'
  # 其他需要的环境变量也可以在这里设置
  

5. 查看系统级cron日志 #

如果上面的方法还没找到问题，可以查看系统的cron日志：

• macOS系统可以用这个命令查看cron相关的日志：

  log show --predicate 'process == "cron"' --info --last 1h
  

• 这个日志会显示cron是否成功触发了任务，以及有没有权限相关的隐藏问题。

6. 确认脚本的执行权限 #

虽然手动执行没问题，但还是可以确保脚本有执行权限：

chmod +x /users/myuser/slots_update.py

不过因为你是直接用Python调用脚本，这个步骤可能不是必须的，但排查时可以顺手确认。

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