Rails从4.2.11升级至5.0时Bundler出现gem版本兼容报错问题咨询

你看到的看似不符合版本逻辑的报错，本质是Bundler的依赖解析规则导致的：Bundler需要同时满足Gemfile中所有gem及其子依赖的全部版本约束，你看到的dropzonejs-rails、spring相关报错只是Bundler输出的冲突链路片段，并非真实冲突源，是解析失败时回溯路径中随机展示的节点，因此才会出现看起来版本范围明明兼容却报错的情况。

从完整报错信息中可直接定位到以下不可兼容的约束：

• json_on_rails ~> 0.2.0 依赖 activerecord ~> 4.0，仅支持Rails 4.x版本，和你指定的Rails 5.0（对应activerecord 5.0.0）完全不兼容，这是最核心的冲突源
• json_on_rails ~> 0.2.0 依赖 mysql2 ~> 0.3，和你指定的mysql2 ~> 0.4.10版本范围无重叠
• 未指定版本的chartkick默认拉取最新的4.0.5版本，该版本要求Ruby >=2.6，和你使用的Ruby 2.3.0不兼容
• 未指定版本的byebug无法匹配pry-byebug 3.7.0要求的byebug ~> 11.0版本约束
• pry ~> 0.10.3和pry-doc 0.12.0要求的pry ~> 0.9存在版本适配差，无法找到公共兼容版本

1. 移除或替换json_on_rails：Rails 5.0已经原生支持JSON类型字段，无需额外依赖该gem；如果必须保留，需升级到支持Rails 5的更新版本，同时调整mysql2的版本约束适配。
2. 固定chartkick版本：在Gemfile中修改为gem 'chartkick', '~> 3.4.2'，该版本同时兼容Ruby 2.3和Rails 5.0。
3. 调整开发依赖约束：
   • 修改byebug声明为gem 'byebug', '~> 11.0'
   • 调整pry版本约束为gem 'pry', '~> 0.10'，或固定pry-doc版本为gem 'pry-doc', '~> 0.11.1'适配pry 0.10.x系列
4. 执行升级命令：删除现有Gemfile.lock文件后，执行bundle update rails触发Rails相关依赖的整体升级，不要直接使用bundle install，后者会优先沿用旧锁文件的版本约束，容易触发冲突。

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