使用Fabric执行makemigrations和migrate时触发Secret Key错误

这个错误的核心原因是Fabric执行命令的独立会话中没有加载到VP_SECRET_KEY环境变量——你直接在服务器上运行命令时，当前登录shell已经加载了这个变量，所以一切正常；但Fabric启动的是全新的shell会话，默认不会继承你手动设置或仅在当前shell中存在的环境变量。

为什么会出现这个差异？ #

当你直接登录服务器时：

• 你的shell会自动加载个人配置文件（比如~/.bashrc、~/.bash_profile），如果这些文件里有export VP_SECRET_KEY=xxx的配置，或者你手动在当前shell中export过该变量，后续命令都能读取到它。
• 而Fabric的run命令启动的是一个独立的非交互式shell会话，即使使用prefix("workon vpenv")激活虚拟环境，若环境变量没有被持久化到虚拟环境的激活脚本或shell启动配置中，这个新会话就无法获取到VP_SECRET_KEY。

解决方案（按推荐程度排序） #

方案1：将环境变量持久化到Virtualenv激活脚本（最推荐） #

把VP_SECRET_KEY添加到虚拟环境的postactivate脚本，这样每次用workon vpenv激活环境时都会自动加载该变量：

1. 登录服务器，打开虚拟环境的激活脚本：

   nano ~/.virtualenvs/vpenv/bin/postactivate
   

2. 添加一行环境变量配置：

   export VP_SECRET_KEY="你的密钥内容"
   

3. 保存退出后，Fabric的prefix("workon vpenv")会自动带上这个变量，后续Django命令就能正常读取了。

方案2：在Fabric中显式加载shell配置文件 #

如果你的VP_SECRET_KEY已经写在~/.bashrc或~/.bash_profile里，可以修改Fabric的prefix语句，先加载配置文件再激活虚拟环境：

def deploy():
    code_directory = "/path/to/somewhere"
    with cd(code_directory):
        # 先加载bashrc中的环境变量，再激活虚拟环境
        with prefix("source ~/.bashrc && workon vpenv"):
            run("git pull")
            run("python manage.py makemigrations --settings=config.settings.production")
            # ... 其余部署命令

方案3：通过Fabric的env传递环境变量（适合临时测试） #

如果你不想修改服务器配置，可以从本地环境变量读取密钥并传递到远程会话（注意不要硬编码密钥到fabfile中）：

import os

def deploy():
    code_directory = "/path/to/somewhere"
    # 从本地终端环境变量读取密钥，传递到远程会话
    env.environ['VP_SECRET_KEY'] = os.environ.get('VP_SECRET_KEY')
    with cd(code_directory):
        with prefix("workon vpenv"):
            run("git pull")
            run("python manage.py makemigrations --settings=config.settings.production")
            # ... 其余部署命令

使用该方案时，需要在运行fab deploy的本地终端先执行：

export VP_SECRET_KEY="你的密钥内容"

验证方法 #

可以在Fabric的命令序列中添加一行测试命令，确认环境变量是否加载成功：

run("echo $VP_SECRET_KEY")

如果能正常输出你的密钥，说明环境变量已经正确加载。

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