Python脚本手动运行正常但Cron任务执行失败的问题排查

这个问题我之前踩过坑！核心原因很简单：Cron的运行环境和你手动登录Shell时的环境完全不是一回事。

你手动登录用户Shell的时候，系统会加载一系列配置文件（比如~/.bashrc、~/.bash_profile或者~/.zshrc，取决于你用的Shell），这些文件里会定义你平时用的环境变量。但Cron在执行任务时，是在一个极简的环境下启动的——它不会自动加载这些用户配置文件，所以哪怕你用同一个用户，Cron能看到的环境变量只有少数默认的（比如PATH、HOME这些），你手动设置的SomePassword自然就找不到了。

下面给你几个实用的解决方案，按安全程度和便捷性排序：

1. 最安全：用文件存储敏感信息，脚本读取文件 #

既然是密码这种敏感数据，不建议直接放到环境变量或者Crontab里（容易泄露）。可以专门创建一个只有当前用户能访问的文件：

• 先创建文件并写入密码：

  echo "your_actual_password" > ~/.some_password
  chmod 600 ~/.some_password  # 设置权限，只有自己能读能写
  

• 然后修改Python脚本，从文件读取：

  import os
  
  password_path = os.path.expanduser("~/.some_password")
  with open(password_path, "r") as f:
      password = f.read().strip()
  

这种方式既避免了环境变量的问题，又提升了安全性。

2. 在Cron任务中加载用户Shell配置 #

如果一定要用环境变量，可以让Cron在执行脚本前先加载你的Shell配置文件。比如修改你的Crontab（执行crontab -e编辑）：

# 用bash登录模式执行脚本，会自动加载~/.bash_profile等配置
* * * * * bash -l -c '/path/to/your/shell_script.sh'

或者直接在Cron命令里先source配置文件：

* * * * * source ~/.bash_profile && /path/to/your/shell_script.sh

注意：不同Shell的配置文件路径可能不一样，比如zsh是~/.zshrc，要对应修改。

3. 直接在Crontab里定义环境变量 #

如果你觉得上面的方法麻烦，也可以直接在Crontab的顶部添加环境变量定义：

# 先定义变量，再写任务
SHELL=/bin/bash
SomePassword=your_password_value
* * * * * /path/to/your/shell_script.sh

Cron会在执行任务前先加载这些变量。不过还是要提醒：密码明文写在Crontab里有安全风险，尽量避免。

4. 在Shell脚本开头定义环境变量 #

也可以在你的Shell脚本最开头添加环境变量的导出：

#!/bin/bash
export SomePassword="your_password_value"
# 然后执行Python脚本
python3 /path/to/your/python_script.py

同样，敏感数据明文写在脚本里要谨慎，记得给脚本设置合适的权限（比如chmod 700 script.sh）。

总结一下，如果是敏感信息，优先选第一种文件读取的方式；如果是普通环境变量，用第二种加载配置文件的方式最省心。

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