Rails部署报错：uninitialized constant URI::Generic 技术求助

我之前也碰到过类似的部署坑，这个错误大多和Ruby环境不匹配、依赖加载异常或者Passenger配置有关，给你几个实用的排查和解决步骤：

1. 验证Passenger使用的Ruby版本是否与开发环境一致 #

开发服务器用的是你本地开发时的Ruby，但Passenger可能默认调用了系统Ruby或者其他版本，导致依赖库加载异常：

• 查看Passenger当前使用的Ruby信息：

  passenger-config ruby-command
  

• 对比你开发环境的Ruby版本：

  ruby -v
  

• 如果版本/路径不一致，在Apache的虚拟主机配置文件（比如/etc/apache2/sites-available/your_app.conf）中添加指定Ruby路径的配置：

  <VirtualHost *:80>
    # 其他配置...
    PassengerRuby /path/to/your/ruby/executable
  </VirtualHost>
  

• 重启Apache生效：

  sudo service apache2 restart
  

2. 手动加载URI标准库 #

Rails 5.2.x中URI是Ruby标准库，但Passenger的部署环境可能没有自动加载该模块，尝试在config/application.rb开头手动引入：

require 'uri'

module YourAppName
  class Application < Rails::Application
    # 其他配置...
  end
end

修改后重启Apache。

3. 清理并重新安装项目依赖 #

部署时可能存在依赖缓存或安装不完整的问题：

1. 进入项目根目录，清理旧依赖：

   bundle clean --force
   

2. 以生产模式重新安装依赖：

   bundle install --deployment
   

3. 重启Apache服务：

   sudo service apache2 restart
   

4. 检查Passenger与Rails版本兼容性 #

过旧的Passenger版本可能不兼容Rails 5.2.3：

• 查看当前Passenger版本：

  passenger -v
  

• 确保Passenger版本在5.3.0及以上（这个版本开始全面支持Rails 5.2），如果版本过低，更新Passenger：
  • 若通过包管理器安装（比如Ubuntu/Debian的apt）：

    sudo apt update && sudo apt install passenger
    

  • 若通过RubyGem安装：

    gem install passenger
    passenger-install-apache2-module
    

  更新完成后记得重启Apache。

5. 查看详细错误日志定位问题 #

如果以上步骤都没解决，查看Apache的错误日志获取更详细的堆栈信息：

tail -f /var/log/apache2/error.log

访问你的网站，观察日志输出，错误堆栈会帮你定位到具体的加载失败点，方便进一步排查。

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