Rails启动报错：安装sqlite3 1.4.x gem时原生扩展编译失败如何解决

根因说明 #

该错误由系统缺少 sqlite3 开发头文件和依赖库导致，编译 sqlite3 Ruby gem 的原生扩展时必须依赖这些系统级组件。

解决步骤 #

• 第一步：安装对应系统的 sqlite3 开发包
  • Debian/Ubuntu 及衍生发行版执行：sudo apt install libsqlite3-dev
  • RHEL/CentOS/Fedora 及衍生发行版执行：sudo dnf install sqlite-devel
  • Arch Linux 及衍生发行版执行：sudo pacman -S sqlite
• 第二步：回到 Rails 项目根目录重新安装 gem 依赖
  执行：bundle install
  若出现系统级 gem 权限报错，可改为安装到项目本地目录：bundle install --path vendor/bundle
• 第三步：验证修复效果
  执行：bin/rails server
  服务正常启动即代表问题已解决。

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