MacOS 10.12下编译PostGIS 2.4.4遇链接错误求助

这个错误是典型的编译器无法找到正确的libiconv库导致的——MacOS系统自带了一个libiconv，但版本可能和PostGIS 2.4.4依赖的API不匹配，而MacPorts安装的libiconv没有被正确关联到编译流程中。下面是几个针对性的解决步骤：

1. 确认MacPorts的libiconv状态 #

首先检查你是否已经安装了MacPorts版的libiconv，并且它处于激活状态：

port installed libiconv

如果输出里没有显示active状态的版本，先安装它：

sudo port install libiconv

如果有多个版本存在，手动激活最新的稳定版（替换成你实际看到的版本号即可）：

sudo port activate libiconv @1.17_0

2. 编译PostGIS时指定libiconv路径 #

在执行PostGIS的configure脚本时，明确告诉它使用MacPorts提供的libiconv，而不是系统自带的：

./configure --with-libiconv=/opt/local

/opt/local是MacPorts的默认安装路径，这个参数会让configure自动去该路径下查找libiconv的头文件和库文件。

3. 手动指定链接参数（如果configure不生效） #

如果上面的步骤还是报错，可以在make阶段手动添加LDFLAGS，强制链接MacPorts的libiconv：

make LDFLAGS="-L/opt/local/lib -liconv"

这个命令会让编译器在链接时优先搜索/opt/local/lib下的库，并明确链接libiconv。

4. 确保MacPorts环境变量优先级 #

有时候系统自带的工具会抢占MacPorts工具的优先级，导致编译时用了系统的libiconv。可以先设置环境变量，让MacPorts的工具和库被优先使用：

export PATH=/opt/local/bin:$PATH
export LD_LIBRARY_PATH=/opt/local/lib:$LD_LIBRARY_PATH

把这两行加到你的~/.bash_profile或~/.zshrc里，确保每次终端启动都生效。

问题根源说明 #

MacOS自带的libiconv是为系统自身服务的，版本通常比较旧，而且可能缺少PostGIS 2.4.4需要的某些符号。MacPorts提供的libiconv是独立维护的更新版本，但默认情况下，编译脚本可能会优先使用系统库，从而导致链接时找不到需要的_iconv、_iconv_close、_iconv_open这些符号。

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