问题：Could not load library "/home/postgres/tmp_basedir_polardb_pg_1100_bld/lib/xxx.so" 错误如何解决？

Question

问题：在使用 PostgreSQL 或其衍生版本（如 PolarDB）时，出现错误提示：“Could not load library '/home/postgres/tmp_basedir_polardb_pg_1100_bld/lib/xxx.so': libssl.so.1.1 cannot open shared object file”，该如何解决？ 此类错误通常发生在动态链接库缺失、版本不兼容或库文件路径未正确配置时。解决方法包括：检查缺失的依赖库并安装、确认库路径是否已加入 LD_LIBRARY_PATH，或重新编译安装相关模块以匹配当前系统环境。

Answer 1

点击展开详细内容

1. 问题现象与初步诊断

在使用 PostgreSQL 或其衍生数据库（如阿里云 PolarDB for PostgreSQL）时，可能会遇到如下错误提示：

ERROR: could not load library '/home/postgres/tmp_basedir_polardb_pg_1100_bld/lib/xxx.so': libssl.so.1.1: cannot open shared object file: No such file or directory

该错误表明 PostgreSQL 或其扩展模块在加载某个共享库（xxx.so）时，依赖的 libssl.so.1.1 动态链接库缺失或路径未正确配置。

2. 错误原因分析

• 依赖库缺失：系统中未安装 OpenSSL 1.1.x 版本。
• 版本不兼容：系统中安装的是 OpenSSL 1.0.x 或 3.x，但模块要求 1.1.x。
• 库路径未配置：动态链接库搜索路径未包含模块所需库的路径。
• 编译环境不一致：模块编译时使用的 OpenSSL 版本与运行环境不一致。

3. 解决方案详解

3.1 检查依赖库是否存在

使用 ldd 命令检查目标模块的依赖情况：

ldd /home/postgres/tmp_basedir_polardb_pg_1100_bld/lib/xxx.so | grep libssl

若输出中显示 libssl.so.1.1 => not found，则说明依赖库缺失。

3.2 安装或升级 OpenSSL 到 1.1.x 版本

不同 Linux 发行版的安装命令如下：

发行版	安装命令
CentOS/RHEL 7	yum install openssl-libs
CentOS/RHEL 8	dnf install openssl11-libs
Ubuntu 18.04	apt install libssl1.1
Ubuntu 20.04 及以上	需手动编译安装 OpenSSL 1.1.x

3.3 配置 LD_LIBRARY_PATH 环境变量

将 OpenSSL 1.1.x 的库路径加入 LD_LIBRARY_PATH：

export LD_LIBRARY_PATH=/usr/local/openssl-1.1.1/lib:$LD_LIBRARY_PATH

可将上述命令写入 ~/.bashrc 或系统级环境配置文件中，以实现持久化配置。

3.4 使用 ldconfig 配置系统库路径

创建库路径配置文件：

echo "/usr/local/openssl-1.1.1/lib" > /etc/ld.so.conf.d/openssl11.conf ldconfig

执行后系统将自动识别新添加的库路径。

3.5 重新编译模块或数据库

若模块是自行编译的，建议在与运行环境一致的前提下重新编译：

./configure --with-openssl=/usr/local/openssl-1.1.1 make clean && make && make install

确保编译时链接的 OpenSSL 版本与运行时一致。

3.6 使用容器或虚拟环境隔离依赖

若生产环境无法更改系统级 OpenSSL 版本，可考虑使用 Docker 容器或虚拟环境部署 PostgreSQL 及其扩展模块，以隔离依赖冲突。

4. 诊断与排查流程图

graph TD A[启动 PostgreSQL 或加载扩展模块] --> B{是否提示 libssl.so.1.1 缺失?} B -->|是| C[使用 ldd 检查依赖] C --> D{libssl.so.1.1 是否存在?} D -->|否| E[安装或编译 OpenSSL 1.1.x] D -->|是| F[检查 LD_LIBRARY_PATH 或 ldconfig 配置] E --> G[配置 LD_LIBRARY_PATH 或 ldconfig] F --> H[重启 PostgreSQL 或重新加载模块] G --> H H --> I[问题是否解决?] I -->|是| J[完成] I -->|否| K[重新编译模块或数据库] K --> H

5. 总结与建议

该类问题本质是动态链接库加载失败，解决过程涉及操作系统库管理、环境变量配置、编译环境一致性等多个层面。建议在部署 PostgreSQL 及其衍生版本时，统一编译与运行环境，并使用版本管理工具（如 Ansible、Chef）进行依赖管理。