Ruby1.8.7+Rails2.0.2环境下MySQL Gem编译失败求助

一、临时解决mysql gem原生扩展构建失败问题 #

Ruby 1.8.7与Ubuntu 20.04的系统库兼容性极差，mysql 2.9.x gem依赖的旧版MySQL开发库、OpenSSL库在当前系统中默认缺失，可通过以下步骤修复：

• 安装兼容依赖包：

  sudo apt-get install libmysqlclient-dev
  # Ubuntu 20.04需手动获取libssl1.0-dev，可下载对应.deb包安装
  

• 指定编译参数安装gem：

  gem install mysql -v '2.9.1' -- --with-mysql-config=/usr/bin/mysql_config
  

但这只是临时方案，Ruby 1.8.7已停止维护多年，与新系统适配问题会持续出现，核心解决路径是逐步升级Ruby和Rails版本。

二、从Ruby 1.8.7 + Rails 2.0.2升级到最新版本的分步指南 #

跨版本跨度极大，直接升级会引发大量兼容性问题，必须按大版本逐步过渡：

1. 先升级Ruby到适配Rails 2.0.2的最高稳定版 #

Rails 2.0.2最高支持Ruby 1.9.3-p551，用Ruby版本管理器（如rbenv）切换版本：

sudo apt-get install rbenv ruby-build
rbenv install 1.9.3-p551
rbenv local 1.9.3-p551

切换后重新运行bundle install，确保旧项目能正常启动运行。

2. 分阶段升级Rails版本 #

第一步：升级到Rails 2.3.18（Rails 2系列最终稳定版）

修改Gemfile：

gem 'rails', '~> 2.3.18'

运行bundle update rails，同步升级其他依赖gem到适配版本，完成后验证项目功能、测试用例正常。

第二步：升级到Rails 3.2.22.5（Rails 3系列最终稳定版）

这一步改动较大，核心调整点：

• Gemfile中添加bundler依赖，替换mysql为mysql2 gem
• 路由语法从map.resources改为resources
• 适配控制器、视图的废弃语法（如调整模板渲染逻辑）
• 修复所有gem依赖冲突，完成后全面测试功能

第三步：升级到Rails 4.2.11.3（Rails 4系列最终稳定版）

核心调整点：

• 移除attr_accessible，替换为强参数（Strong Parameters）
• 路由中match方法需指定via参数
• 更新database.yml的数据库连接格式
• 替换已停止维护的旧gem，完成后验证测试用例

第四步：升级到最新版Rails（当前为7.x）

• 先升级Ruby到最新稳定版（如3.2.2），Rails 7要求Ruby 2.7+
• 修改Gemfile指定gem 'rails', '~> 7.0'
• 处理框架重大变化：适配Importmaps/Webpacker、Turbo，调整Active Record语法等
• 运行rails app:update自动生成配置变化，手动合并冲突
• 全面测试所有功能，修复剩余兼容性问题

3. 升级关键注意事项 #

• 每完成一个大版本升级，必须运行全部测试用例，确认核心功能正常后再推进下一步
• 升级前备份代码和数据库，每一步都提交代码，避免回退困难
• 对于项目中使用的自定义插件/旧gem，优先寻找兼容新版本的替代方案，无替代则重写对应功能
• 安装最新Ruby时需提前安装系统依赖：

  sudo apt-get install build-essential libssl-dev libreadline-dev zlib1g-dev
  

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