Mac安装运行PostgreSQL 16时出现libpq.5.dylib缺失错误求助

你遇到的错误是因为系统找不到PostgreSQL 16的libpq.5.dylib库文件——brew安装的postgresql@16库文件不在默认的/usr/local/lib路径下，以下是具体解决步骤：

方法一：创建软链接到系统库路径 #

brew安装的postgresql@16库文件位于/usr/local/opt/postgresql@16/lib/，直接创建软链接到/usr/local/lib即可：

ln -s /usr/local/opt/postgresql@16/lib/libpq.5.dylib /usr/local/lib/libpq.5.dylib

执行完后重新运行psql即可。

方法二：配置环境变量指定库路径 #

将PostgreSQL@16的bin和lib路径加入环境变量，确保系统能找到对应的文件：

1. 打开你的shell配置文件（zsh用户是~/.zshrc，bash用户是~/.bash_profile）：

open -e ~/.zshrc

2. 在文件末尾添加以下内容：

export PATH="/usr/local/opt/postgresql@16/bin:$PATH"
export DYLD_LIBRARY_PATH="/usr/local/opt/postgresql@16/lib:$DYLD_LIBRARY_PATH"

3. 保存文件后，刷新环境变量：

source ~/.zshrc

之后重新运行psql即可。

方法三：处理多版本PostgreSQL冲突 #

如果之前安装过其他版本的PostgreSQL，可能存在路径冲突：

1. 先停止所有PostgreSQL服务：

brew services stop --all postgresql

2. 卸载旧版本（如果不需要的话）：

brew uninstall postgresql

3. 强制链接postgresql@16：

brew link postgresql@16 --force

完成后重新启动服务并运行psql：

brew services start postgresql@16
psql

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