Capistrano部署AWS EC2应用时环境变量无法被应用读取怎么办？

这个问题我之前也碰到过！核心原因是Capistrano部署的应用进程和你SSH登录时的shell会话，用的是完全不同的环境变量上下文——你SSH进去时加载的是用户shell配置（比如~/.bashrc、~/.bash_profile）里的变量，但应用服务器（比如Puma、Unicorn）通常是通过systemd/init这类系统服务启动的，根本不会加载这些用户级的shell配置，所以应用进程拿不到这些变量。

下面给你几个靠谱的解决办法，按推荐程度排序：

这是最直接的方式，适合变量不多的情况。在你的config/deploy.rb或者对应环境的配置文件（比如config/deploy/production.rb）里添加：

set :default_env, {
  'RAILS_MASTER_KEY' => 'your_actual_key',
  'DATABASE_URL' => 'postgres://user:password@db-host:5432/db-name',
  # 把你需要的其他变量都加在这里
}

Capistrano会在部署过程中把这些变量注入到应用的运行环境里，部署后重启应用服务器（比如Puma）就能生效。

如果习惯用.env文件管理变量，可以用capistrano-dotenv插件：

• 先在Gemfile里添加：gem 'capistrano-dotenv', require: false
• 然后在Capfile里引入：require 'capistrano/dotenv'
• 在部署配置里指定服务器上的.env路径（一般放在shared目录，避免每次部署覆盖）：

  set :dotenv_file, '/var/www/your-app/shared/.env'
  

  你可以手动把本地的.env文件上传到服务器的这个路径，或者用Capistrano的上传任务自动化这个步骤。

如果你的应用是用systemd管理的（现在大部分EC2实例都是这样），直接给服务文件添加环境变量是最稳妥的，完全不受shell配置影响：

• 找到你的应用服务文件，一般在/etc/systemd/system/your-app.service
• 在[Service]区块里添加Environment行：

  [Service]
  User=deploy
  WorkingDirectory=/var/www/your-app/current
  ExecStart=/usr/local/bin/bundle exec puma -C config/puma.rb
  # 添加环境变量
  Environment="RAILS_MASTER_KEY=your_key_here"
  Environment="REDIS_URL=redis://localhost:6379/0"
  

• 保存后重新加载systemd配置：sudo systemctl daemon-reload
• 重启应用服务：sudo systemctl restart your-app.service

如果上面的方法都不行，先确认Capistrano用的deploy用户是否能拿到这些变量：
在config/deploy.rb里加一个临时任务：

task :check_deploy_env do
  on roles(:app) do
    execute :printenv
  end
end

然后运行cap production check_deploy_env，看看输出里有没有缺失的变量。如果没有，说明deploy用户的shell配置里没加这些变量，可以在~deploy/.bashrc或者~deploy/.bash_profile里添加，但注意：如果应用是systemd启动的，这个方法没用，因为systemd不会加载用户shell配置。

最后提醒几个注意事项：

• 敏感变量绝对不要提交到代码仓库，用dotenv或者Capistrano的加密配置（比如capistrano-secrets-yml）管理
• 任何环境变量变更后，一定要重启应用服务器，进程只有重启才能读取新的环境变量
• 如果用Passenger作为应用服务器，需要在Passenger的配置里设置SetEnv指令，比如在Nginx配置里加：SetEnv RAILS_MASTER_KEY your_key_here

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