Crontab中Python脚本sys.path配置失效问题排查

嘿，这个问题我碰到过好多次了，核心是你搞混了系统PATH环境变量和Python的模块搜索路径sys.path这俩完全不同的东西！

为什么原来的方法能正常运行？ #

之前你在test.py里加sys.path.append('/home/dan')，是直接把/home/dan塞进了Python的模块搜索路径里——你的foo模块放在/home/dan/foo/下，Python必须找到这个父目录，才能识别import foo的指令，所以当时运行没问题。

为什么crontab里加路径没用？ #

当你注释掉sys.path.append，只在crontab顶部加路径定义（比如PATH=/home/dan:$PATH），这只会让系统在执行命令时能找到/home/dan里的可执行文件，但Python根本不会把系统PATH里的目录自动加到sys.path里。

Python的模块搜索路径默认只包含这几类：

• 脚本所在的当前工作目录
• Python安装目录下的site-packages文件夹
• 环境变量PYTHONPATH里指定的路径

靠谱的解决办法 #

给你几个实用方案，选哪个都行：

1. 恢复sys.path.append：最简单直接，原来的逻辑完全没问题，而且不受运行环境影响。
2. 在crontab里设置PYTHONPATH：在crontab任务上方加一行：

   PYTHONPATH=/home/dan
   

   这样Python启动时会自动把这个路径加到sys.path，自然就能找到foo模块了。
3. 在任务命令里直接指定PYTHONPATH：如果不想全局设置，也可以把变量写在命令前面：

   * * * * * PYTHONPATH=/home/dan python /path/to/your/test.py
   

4. 搭配shebang和绝对路径：给test.py加上正确的shebang行（比如#!/usr/bin/env python3），赋予执行权限（chmod +x test.py），然后在crontab里用绝对路径执行脚本，同时搭配PYTHONPATH设置。

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