M1 Mac安装pg gem失败：‘PQconnectdb类型冲突’问题排查

1. x86_64-darwin-21 日志目录是否异常？ #

这是正常现象：如果你的Ruby环境是x86_64架构（比如通过Rosetta终端安装的rbenv/rvm或Ruby），编译日志就会生成在x86_64-darwin-21目录下。可以运行以下命令确认Ruby架构：

ruby -e "puts RUBY_PLATFORM"

如果输出是arm64-darwin-21，说明是原生M1环境；如果是x86_64-darwin-21，则是Rosetta兼容环境。

2. 解决 libpq 找不到 & PQconnectdb 类型冲突问题 #

M1上Homebrew安装的libpq分两种路径，对应不同架构的Ruby环境：

原生arm64 Ruby环境 #

Homebrew安装的libpq默认路径是/opt/homebrew/opt/libpq，直接指定pg_config路径安装即可：

# 直接安装pg gem
gem install pg -- --with-pg-config=/opt/homebrew/opt/libpq/bin/pg_config

# 用bundler安装
bundle config build.pg --with-pg-config=/opt/homebrew/opt/libpq/bin/pg_config
bundle install

注意：macOS上的动态库后缀是.dylib而非.so，无需手动找libpq.so，gem会通过pg_config自动加载依赖。

Rosetta x86_64 Ruby环境 #

如果你的Ruby是x86版本，需要先通过Rosetta终端安装x86版的libpq：

arch -x86_64 brew install libpq

再指定x86版的pg_config路径安装：

# 直接安装pg gem
gem install pg -- --with-pg-config=/usr/local/opt/libpq/bin/pg_config

# 用bundler安装
bundle config build.pg --with-pg-config=/usr/local/opt/libpq/bin/pg_config
bundle install

3. libpq与pg gem版本兼容问题 #

pg gem与libpq基本向前兼容，但最新版libpq（15.1）建议搭配pg gem 1.5.x及以上版本。如果还是出现类型冲突，可能是系统存在多个libpq版本（比如macOS自带的旧版），可以临时设置环境变量让编译器优先使用Homebrew版本：

# arm64环境
export PATH="/opt/homebrew/opt/libpq/bin:$PATH"
export LDFLAGS="-L/opt/homebrew/opt/libpq/lib"
export CPPFLAGS="-I/opt/homebrew/opt/libpq/include"

# x86_64环境
export PATH="/usr/local/opt/libpq/bin:$PATH"
export LDFLAGS="-L/usr/local/opt/libpq/lib"
export CPPFLAGS="-I/usr/local/opt/libpq/include"

# 重新安装pg gem
gem install pg

4. 快速排查步骤 #

• 先确认Ruby架构和libpq安装路径
• 清理错误的bundle配置（如果之前设置过）：bundle config unset build.pg
• 重新执行安装命令时指定正确的pg_config路径

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