首次在RubyMine运行Rails项目遇库版本不兼容错误的解决咨询

问题描述 #

首次在RubyMine中运行Rails项目时，出现库版本不兼容错误，终端报错如下：

/bin/zsh -c "bash -c 'env RBENV_VERSION=2.7.5 /usr/local/Cellar/rbenv/1.2.0/libexec/rbenv exec ruby -x /Users/user1/srccompanyl/bin/bundle exec ruby /Users/user1/srccompanyl/bin/rails server -b 0.0.0.0 -p 3000 -e development'"
Traceback (most recent call last):
    27: from /Users/user1/srccompanyl/bin/rails:4:in `<main>'
    26: from /Users/user1/srccompanyl/bin/rails:4:in `require'
    25: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/railties-6.1.6.1/lib/rails/commands.rb:18:in `<top (required)>'
    24: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/railties-6.1.6.1/lib/rails/command.rb:48:in `invoke'
    23: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/railties-6.1.6.1/lib/rails/command/base.rb:69:in `perform'
    22: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/thor-1.0.1/lib/thor.rb:392:in `dispatch'
    21: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/thor-1.0.1/lib/thor/invocation.rb:127:in `invoke_command'
    20: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/thor-1.0.1/lib/thor/command.rb:27:in `run'
    19: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/railties-6.1.6.1/lib/rails/commands/server/server_command.rb:135:in `perform'
    18: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/railties-6.1.6.1/lib/rails/commands/server/server_command.rb:135:in `tap'
    17: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/railties-6.1.6.1/lib/rails/commands/server/server_command.rb:138:in `block in perform'
    16: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/activesupport-6.1.6.1/lib/active_support/dependencies.rb:332:in `require'
    15: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/activesupport-6.1.6.1/lib/active_support/dependencies.rb:299:in `load_dependency'
    14: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/activesupport-6.1.6.1/lib/active_support/dependencies.rb:332:in `block in require'
    13: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/activesupport-6.1.6.1/lib/active_support/dependencies.rb:332:in `require'
    12: from /Users/user1/srccompanyl/config/application.rb:16:in `<top (required)>'
    11: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/bundler-1.17.3/lib/bundler.rb:114:in `require'
    10: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/bundler-1.17.3/lib/bundler/runtime.rb:65:in `require'
     9: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/bundler-1.17.3/lib/bundler/runtime.rb:65:in `each'
     8: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/bundler-1.17.3/lib/bundler/runtime.rb:76:in `block in require'
     7: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/bundler-1.17.3/lib/bundler/runtime.rb:76:in `each'
     6: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/bundler-1.17.3/lib/bundler/runtime.rb:81:in `block (2 levels) in require'
     5: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/bundler-1.17.3/lib/bundler/runtime.rb:81:in `require'
     4: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/pg-1.2.3/lib/pg.rb:5:in `<top (required)>'
     3: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/activesupport-6.1.6.1/lib/active_support/dependencies.rb:332:in `require'
     2: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/activesupport-6.1.6.1/lib/active_support/dependencies.rb:299:in `load_dependency'
     1: from /Users/user1/.rvm/gems/ruby-2.7.5/gems/activesupport-6.1.6.1/lib/active_support/dependencies.rb:332:in `block in require'
/Users/user1/.rvm/gems/ruby-2.7.5/gems/activesupport-6.1.6.1/lib/active_support/dependencies.rb:332:in `require': incompatible library version - /Users/user1/.rvm/gems/ruby-2.7.5/gems/pg-1.2.3/lib/pg_ext.bundle (LoadError)

Process finished with exit code 1

已执行bundler install但问题未解决，需调试修复方案，同时确认是否需要匹配rbenv版本及具体操作方法。

修复方案 #

1. 优先处理pg gem的版本兼容问题 #

报错根源是pg-1.2.3的pg_ext.bundle库版本不兼容，通常是pg gem编译时依赖的PostgreSQL库与当前系统版本不匹配，或者编译环境存在冲突。操作步骤：

• 卸载当前pg gem：

  gem uninstall pg -v 1.2.3
  

• 重新安装pg gem，指定系统PostgreSQL的配置路径（可通过which pg_config查找路径）：

  gem install pg -v 1.2.3 -- --with-pg-config=/usr/local/bin/pg_config
  

• 若项目允许，可尝试升级pg gem到兼容版本：修改Gemfile中的pg版本为gem 'pg', '~> 1.4'，然后执行：

  bundle update pg
  

2. 解决rbenv与rvm共存的冲突 #

报错命令中同时出现rbenv和rvm路径，两种Ruby版本管理工具共存会导致环境混乱，必须统一使用其中一种：

• 若选择rbenv：
  1. 关闭当前终端，打开新终端确认rvm未加载（执行rvm -v，提示命令不存在则生效）。
  2. 确保项目目录下的.ruby-version文件内容为2.7.5。
  3. 执行rbenv rehash刷新环境。
  4. 重新执行bundle install后启动服务器。
• 若选择rvm：
  1. 修改~/.zshrc或~/.bashrc，注释掉rbenv相关配置行，关闭rbenv加载。
  2. 执行rvm use 2.7.5 --default切换到指定Ruby版本。
  3. 重新执行bundle install后启动服务器。

3. 检查RubyMine终端环境配置 #

确保RubyMine使用的环境与本地终端一致：

• 打开RubyMine的Preferences（macOS）或Settings（Windows/Linux）。
• 进入Tools > Terminal，确认Shell path为系统默认shell（如/bin/zsh）。
• 进入Languages & Frameworks > Ruby SDK and Gems，确认选中的Ruby SDK为2.7.5，且对应gem列表中有正确版本的pg gem。

4. 清理缓存并重新构建 #

• 清理bundler缓存：

  bundle clean --force
  

• 删除项目目录下的Gemfile.lock，重新执行：

  bundle install
  

• 清理RubyMine缓存：File > Invalidate Caches...，选择Invalidate and Restart。

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