已设置HOME变量但Bundler仍崩溃，AWS Elastic Beanstalk部署Rails5遇阻

我之前帮不少开发者踩过这个rb-readline + Elastic Beanstalk的坑，你说的控制台设置HOME没用、EC2里HOME正常但应用还是报错的情况，确实大概率是应用启动的上下文和你登录EC2的用户上下文不一致——比如EB可能用了chroot环境，或者以其他系统用户（比如webapp）启动应用，导致你在控制台设置的HOME没传递过去。给你几个优先级从高到低的解决方案：

方案1：直接移除rb-readline（最推荐） #

rb-readline本质是给开发环境的rails console提供更好的命令行体验，生产环境其实完全不需要它——EB上的生产应用几乎不会直接用rails console操作，而且系统自带的readline库足够支撑需求。

• 打开你的Gemfile，把rb-readline移到:development组里（如果之前在全局），或者直接删除这一行：

  # 改成这样（如果需要保留开发环境使用）
  group :development do
    gem 'rb-readline'
  end
  

• 本地执行bundle install --without development，然后重新打包部署到EB，问题大概率直接解决。

方案2：强制在应用启动脚本中设置HOME #

如果因为某些原因必须保留rb-readline，那就要确保应用启动时能拿到正确的HOME。EB的应用部署钩子和配置文件可以帮我们做到这一点：

1. 在你的Rails项目根目录创建.ebextensions文件夹（如果没有的话）
2. 在里面新建一个配置文件，比如01_enforce_home.config，内容如下：

   option_settings:
     # 先在EB环境变量里明确设置HOME
     - namespace: aws:elasticbeanstalk:application:environment
       option_name: HOME
       value: /home/webapp  # 这里要对应EB启动应用的用户HOME，一般是webapp或者ec2-user
   container_commands:
     # 确保应用用户对HOME目录有读写权限（rb-readline需要写配置文件）
     01_fix_home_permissions:
       command: chown webapp:webapp /home/webapp
     # 把HOME写入应用启动的前置钩子脚本
     02_add_home_to_deploy_hook:
       command: echo 'export HOME="/home/webapp"' >> /opt/elasticbeanstalk/hooks/appdeploy/pre/05_set_env_vars.sh
   

3. 注意：如果你的EB环境用的是Puma服务器，还可以直接修改Puma的配置文件来强制设置HOME：

   files:
     "/opt/elasticbeanstalk/support/conf/puma.conf":
       mode: "000644"
       owner: root
       group: root
       content: |
         env HOME=/home/webapp
   

4. 重新打包部署，这样应用启动时就会拿到正确的HOME路径了。

方案3：验证应用进程的实际上下文 #

如果上面的方法还是不行，你可以登录EC2实例，手动排查应用启动的用户和环境变量：

• 用ps aux | grep puma（或者grep rails/grep unicorn，看你用的服务器）查看应用进程的用户，比如输出里的USER列如果是webapp，那对应的HOME就是/home/webapp
• 进入应用的部署目录（一般是/var/app/current），切换到应用用户：su webapp，然后执行echo $HOME确认路径
• 再运行rails c production，执行ENV['HOME']，看看应用进程能拿到的HOME是不是正确的。如果不对，就回到方案2调整配置里的HOME值。

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