Rails执行rake时database.yml读取ENV变量DB_HOST为空报错如何解决

• 第一步先确认当前shell的环境变量是否生效：在执行rake的同一终端窗口运行echo $DB_HOST，若输出为空，说明环境变量未正确加载到当前shell。常见原因包括：环境变量配置在仅交互式shell才加载的文件（如_/.bashrc、/.zshrc），配置后未执行source 配置文件或重启终端，当前使用的shell和配置变量的shell不匹配（如配置在zsh配置文件但当前用的是bash）。
• 若echo输出正常，验证JRuby运行时能否读取到变量：执行jruby -e 'p ENV["DB_HOST"]'，若输出为nil，说明JRuby继承父shell环境变量时出现异常。JRuby部分版本在非交互式shell运行时，确实存在环境变量继承的已知问题，尤其是通过rvm、rbenv等版本工具管理Ruby版本时，环境变量会被版本管理工具的隔离逻辑过滤。
• 确认Rake运行时的Rails环境：你的DB_HOST配置在database.yml的development区块，若执行rake时未指定RAILS_ENV，部分旧版本Rails会默认使用production环境，不会加载development相关的环境变量配置。如果项目使用了dotenv类的环境变量管理gem，还需要确认DB_HOST是否写在对应环境的.env文件中，默认情况下dotenv仅加载根目录的.env文件，不会自动加载.env.development等环境专属配置。

• 临时验证方案：执行rake命令时主动传入环境变量，确认问题是否解决：

  DB_HOST=你的数据库实际地址 jruby -S bundle exec rake assets:clean RAILS_ENV=development
  

  若执行成功即可确认是环境变量加载问题，再根据你的使用场景选择永久修复方案。
• 永久修复方案：
  • 若需要所有shell场景都能读到该变量：把环境变量配置写到~/.zshenv（zsh）或~/.bash_profile（bash），这两个文件会被非交互式shell加载，避免终端运行命令时读不到变量。
  • 若使用dotenv管理项目环境变量：在Rakefile顶部增加加载对应环境配置的逻辑：

    require 'dotenv'
    Dotenv.load(".env.#{ENV['RAILS_ENV'] || 'development'}", '.env')
    

  • 若使用rbenv管理JRuby版本：直接在项目根目录创建.rbenv-vars文件，写入DB_HOST=你的数据库地址，rbenv会自动为该项目下的所有Ruby命令加载该文件的环境变量。
• 额外注意：你提供的database.yml配置示例中url缺少结尾的双引号，修正后的正确写法为：

  development:
    <<: *default
    url: "mysql://user:pass@<%= ENV['DB_HOST'] %>"
  

  语法错误也可能导致配置解析异常，引发同类报错。

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