Jelastic中rake_deploy无法读取ENV环境变量的问题排查

AI 小北

2026-5-26

解决Rails部署中rake_deploy无法读取环境变量的问题

这种环境变量在命令行和部署流程中不一致的情况，我在Jelastic+Nginx部署Rails应用时也碰到过几次，核心原因是不同执行场景下的shell环境加载的配置文件不一样，咱们一步步来解决：

问题根源拆解

.bashrc 只有在交互式shell（比如你手动SSH登录敲命令）才会加载，而部署脚本（比如rake_deploy）通常是以非交互式/非登录shell执行的，根本不会读取.bashrc里的变量。
Nginx配置文件（比如/etc/nginx/app_servers/nginx-passenger.conf）里的环境变量，是给Passenger运行Rails应用实例用的，但部署时的rake任务是单独通过SSH执行的进程，不会自动继承Nginx的环境变量。

把你的数据库变量放到所有shell都会加载的位置，比如/etc/profile.d/目录下创建一个自定义脚本：

# 创建并编辑脚本
sudo nano /etc/profile.d/my_app_env.sh

在里面添加变量：

export DB_NAME="your_db_name"
export DB_PASSWORD="your_db_password"

保存后，不管是交互式shell还是部署用的非交互式shell，都会自动加载这些变量。

如果不想改全局配置，可以在执行rake_deploy的时候，先手动source包含变量的文件，或者直接在命令前缀定义变量：

# 方式一：source你的变量文件
source ~/.bashrc && rake deploy

# 方式二：直接在命令前指定变量
DB_NAME="your_db_name" DB_PASSWORD="your_db_password" rake deploy

这种方式适合临时调试，或者你只想给部署流程单独设置变量的场景。

Jelastic控制面板本身就有环境变量管理功能，直接在应用的设置里添加你的数据库变量：

登录Jelastic面板，找到你的应用环境
进入「Settings」→「Environment Variables」
添加DB_NAME和DB_PASSWORD的键值对
保存后，Jelastic会确保这些变量在应用运行、部署脚本执行等所有场景下都能被读取到，这是最省心的方式，不用手动维护各种配置文件。

如果你发现不仅部署时变量有问题，Rails应用运行时也读不到，那要检查Nginx里的Passenger配置是否正确：
不要用普通的export命令，而是用Passenger专门的指令：

# 在nginx-passenger.conf里添加
passenger_env_var DB_NAME "your_db_name";
passenger_env_var DB_PASSWORD "your_db_password";

修改后重启Nginx：

sudo service nginx restart

这个是确保Rails应用本身能拿到变量，和部署时的rake任务是两个独立的场景，要分开处理。

写个简单的rake任务来测试环境变量：

# lib/tasks/env_check.rake
task :env_check do
  puts "DB_NAME: #{ENV['DB_NAME']}"
  puts "DB_PASSWORD: #{ENV['DB_PASSWORD']}"
end

然后用部署流程的方式执行这个任务，看看输出是否正确，就能快速定位变量有没有加载成功。

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