Crontab调度Shell脚本内Python脚本未执行的问题排查

常见原因及对应解决方法 #

1. 使用Python解释器的绝对路径 #

crontab的PATH环境变量比普通用户登录后的环境要精简很多，大概率找不到你手动执行时默认使用的python/python3命令。

• 先在终端执行which python3（或which python，根据你的实际版本），获取Python解释器的绝对路径，比如得到/usr/bin/python3。
• 修改脚本中的调用命令，同时把错误输出也重定向到日志（方便排查问题）：

  /usr/bin/python3 /tmp/test.py > /tmp/test.log 2>&1
  

2. 补全脚本依赖的环境变量 #

部分Python脚本依赖用户环境中的变量（比如PYTHONPATH），但crontab运行时不会加载这些变量。

• 可以在主Shell脚本开头导入用户的环境配置：

  source $HOME/.bashrc
  # 若使用zsh则替换为 source $HOME/.zshrc
  

• 或者直接在调用Python的命令前指定所需变量：

  PYTHONPATH=/path/to/your/python/modules /usr/bin/python3 /tmp/test.py > /tmp/test.log 2>&1
  

3. 检查脚本权限与shebang行 #

• 确保/tmp/test.py有可执行权限：执行chmod +x /tmp/test.py。
• 在Python脚本开头添加正确的shebang行，指定解释器路径：

  #!/usr/bin/python3
  

4. 验证crontab的运行身份与条件触发 #

• 检查whoami == "test"的条件是否真的满足：crontab默认以创建它的用户身份运行，如果你的crontab是root创建的，whoami会返回root，不会触发Python脚本执行。可以用crontab -u test -e编辑test用户的crontab条目，确保以正确身份运行。

5. 捕获主脚本的运行日志 #

给crontab中的主脚本条目添加输出重定向，方便排查整体运行情况：

0 0 * * * /path/to/your/main_script.sh > /tmp/main_script.log 2>&1

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