Cron执行Python脚本卡在import语句问题排查求助

这种情况我碰到过好多次，大概率是cron的执行环境和你终端的环境不一致导致的，咱们一步步排查：

1. Python解释器路径不匹配 #

终端里你用的python可能是虚拟环境里的特定版本，或者是自定义安装的Python，但cron默认使用系统全局的Python解释器。如果你的脚本依赖的包只安装在虚拟环境里，那cron调用系统Python时自然找不到这些包，就会卡在import环节。

解决方法：

• 在exec_script.sh里用绝对路径调用Python，比如：

  #!/bin/bash
  /home/your_username/.virtualenvs/your_env/bin/python /full/path/to/script_30_minutes.py
  

• 或者先激活虚拟环境再执行脚本：

  #!/bin/bash
  source /home/your_username/.virtualenvs/your_env/bin/activate
  python /full/path/to/script_30_minutes.py
  deactivate
  

• 可以在脚本里加一行which python，对比终端和cron执行后的输出，就能确认路径差异。

2. 脚本或模块的路径问题 #

cron的默认工作目录是用户的主目录（比如/home/your_username），如果你的脚本里用了相对路径import自定义模块，或者依赖的文件在其他目录，终端里因为你cd到了脚本所在目录所以能找到，但cron里就会报错。

解决方法：

• 在Python脚本开头添加路径配置，把脚本所在目录加入Python的搜索路径：

  import sys
  import os
  # 将脚本所在目录添加到PYTHONPATH
  sys.path.append(os.path.dirname(os.path.abspath(__file__)))
  

• 或者在exec_script.sh里先切换到脚本所在目录再执行：

  #!/bin/bash
  cd /full/path/to/script_folder
  python script_30_minutes.py
  

3. 权限不足 #

cron执行时的用户权限可能和你终端用户不一样，或者脚本、依赖模块的权限设置有问题，导致无法读取模块文件。比如你用普通用户在终端执行没问题，但cron用root执行时，某些模块文件的权限不允许root读取；反过来也可能。

解决方法：

• 确保exec_script.sh和script_30_minutes.py有执行权限：chmod +x exec_script.sh、chmod +r script_30_minutes.py
• 在cron配置里指定执行用户，比如：*/30 * * * * your_username sh exec_script.sh（替换成你的用户名）

4. 捕获错误日志，定位具体问题 #

目前你只看到“脚本已执行”，但没后续输出，说明import时出错了但错误信息没被记录。必须把错误输出重定向到日志文件，才能知道具体是哪个模块导入失败。

解决方法：

• 修改cron配置，把所有输出（包括错误）写入日志：

  */30 * * * * sh exec_script.sh >> /var/log/cron_script.log 2>&1
  

• 或者在exec_script.sh里单独处理Python脚本的输出：

  python script_30_minutes.py >> script_output.log 2>&1
  

  查看日志文件就能看到具体的ImportError信息，比如是找不到第三方包，还是自定义模块，或者系统依赖库缺失。

5. 系统级依赖缺失 #

有些Python模块（比如numpy、opencv这类带C扩展的）依赖系统库，如果cron的环境变量里没包含这些库的路径，或者系统库没安装，也会导致import失败。这种情况日志里会提示类似“libxxx.so not found”的错误，针对性安装系统库或者设置LD_LIBRARY_PATH即可。

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