激活虚拟环境无法导入环境变量的问题排查

嘿，我来帮你揪出这个问题的根源——夜间运行的bash脚本明明source了virtualenv的activate，但$PRODUCTION_ENV还是空，导致Python抛出KeyError，大概率是踩了这几个常见的坑：

1. 脚本的执行环境或路径不对 #

首先排查最基础的问题：

• Shebang行错误：你的脚本开头是不是写了#!/bin/sh？如果是，赶紧改成#!/bin/bash。因为sh是POSIX标准shell，不支持bash的一些语法，而virtualenv的activate脚本里用了bash特有的写法，用sh运行的话source会失效。
• 相对路径导致source失败：如果你写的是source ./bin/activate，但脚本运行时的工作目录不是virtualenv所在的目录，这个相对路径就找不到文件，等于白source了。一定要用绝对路径，比如source /home/your_user/your_project/venv/bin/activate。

2. PRODUCTION_ENV的定义没被加载 #

如果这个变量是你平时在交互式shell的配置文件（比如~/.bashrc、~/.bash_profile）里定义的，那后台/非交互式运行的脚本默认不会加载这些文件！因为bash只有在交互式登录时才会自动读取这些配置。

解决办法二选一：

• 直接把export PRODUCTION_ENV=your_value加到activate脚本末尾，或者在source activate之后，在你的bash脚本里手动导出这个变量；
• 或者在脚本开头手动source你的配置文件，比如source ~/.bashrc，但要注意如果.bashrc里有类似[[ $- == *i* ]] && ...的判断（只给交互式shell加载内容），得把这个判断去掉，或者调整逻辑让非交互式shell也能拿到变量。

3. Cron运行的特殊限制（如果是用cron调度脚本） #

cron的默认环境变量非常精简，PATH和其他变量都和你平时用的交互式shell不一样，哪怕脚本里写对了source，也可能因为环境缺失出问题。

解决方法：

• 在cron任务里用登录shell模式运行脚本：

  0 2 * * * /bin/bash -l /path/to/your/script.sh
  

  这里的-l参数会让bash以登录shell启动，自动加载~/.bash_profile这类配置文件，环境变量就全了；
• 或者在脚本开头手动设置必要的环境变量，比如PATH=/usr/local/bin:/usr/bin:$PATH，再加上export PRODUCTION_ENV=your_value。

4. 快速验证source是否成功的小技巧 #

在脚本里source activate之后，加一行echo "VIRTUAL_ENV is: $VIRTUAL_ENV"，然后查看脚本的运行日志。如果VIRTUAL_ENV是空的，说明source根本没成功（路径或shell的问题）；如果VIRTUAL_ENV有值，但PRODUCTION_ENV还是空，那就是这个自定义变量没被正确导出。

给你一个参考的正确脚本示例：

#!/bin/bash
# 用绝对路径source virtualenv的activate脚本
source /home/your_project/venv/bin/activate
# 手动导出你的自定义环境变量
export PRODUCTION_ENV="production"
# 运行Python管理命令
python /home/your_project/manage.py your_management_command

另外，看你提供的activate脚本内容，它只负责设置virtualenv相关的变量（比如VIRTUAL_ENV、PATH、命令提示符），并不会帮你处理PRODUCTION_ENV这种自定义变量，所以这个变量必须你自己手动导出哦！

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