Rails项目安装pdf-extract gem失败：依赖sqlite与pg冲突（Heroku要求）

我来帮你搞定这个麻烦！你遇到的是典型的gem依赖环境冲突——pdf-extract默认依赖sqlite3，但Heroku平台强制要求生产环境使用PostgreSQL，这就导致bundle install时触发了sqlite3原生扩展的编译失败。下面是一步步的解决方法：

1. 先规范Gemfile的环境分组 #

首先确保你的Gemfile把数据库依赖按环境隔离开，避免生产环境拉取sqlite3：

group :development, :test do
  # 开发和测试环境用sqlite3
  gem 'sqlite3'
end

group :production do
  # 生产环境（Heroku）用pg
  gem 'pg'
end

2. 处理pdf-extract的依赖安装问题 #

pdf-extract确实硬依赖sqlite3，但我们可以通过两种方式规避冲突：

• 本地开发环境安装：如果只是本地开发用，直接执行bundle时跳过生产环境依赖：

  bundle install --without production
  

  这样只会安装开发/测试组的gem，包括sqlite3，就能顺利完成pdf-extract的安装。
• 跨环境使用的替代方案：如果需要在生产环境也用PDF提取功能，那pdf-extract的sqlite3依赖在Heroku上是跑不起来的，建议换成不依赖sqlite3的同类gem，比如pdf-reader，它专注于PDF内容提取，没有数据库依赖，用法也很简单。

3. 解决本地sqlite3编译失败的问题 #

如果本地执行bundle install时还是出现sqlite3原生扩展报错，那是因为你缺少sqlite的开发依赖库，根据系统安装即可：

• Ubuntu/Debian系统：

  sudo apt-get install libsqlite3-dev
  

• macOS（用Homebrew）：

  brew install sqlite3
  

4. Heroku部署的最终检查 #

Heroku默认会自动用bundle install --without development test来安装依赖，只要你的Gemfile分组正确，生产环境就不会安装sqlite3。如果之前已经提交过错误的Gemfile，记得重新部署前执行：

git add Gemfile Gemfile.lock
git commit -m "Fix database dependency groups for Heroku"
git push heroku main

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