Docker容器中PostgreSQL驱动加载GLIBCXX_3.4.30失败排查求助

我在Docker容器中执行以下命令，检测到/usr/lib/x86_64-linux-gnu/libstdc++.so.6中存在GLIBCXX_3.4.30：

$ strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX_3.4.30
GLIBCXX_3.4.30

但在同一容器中运行应用时，PostgreSQL驱动报错：

org.postgresql.util.PSQLException: ERROR: could not load library "/usr/lib/postgresql/13/lib/llvmjit.so": /lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib/x86_64-linux-gnu/libz3.so.4)

确认llvmjit.so文件确实存在：

# ls /usr/lib/postgresql/13/lib/llvmjit.so
/usr/lib/postgresql/13/lib/llvmjit.so

我的Dockerfile内容如下：

FROM alpine

RUN apk upgrade --no-cache
RUN apk add libstdc++ postgresql-client leiningen

WORKDIR /ui-service
COPY . .
CMD ["lein", "ring", "server-headless", "3000"]
EXPOSE 3000

请问缺少什么配置导致PostgreSQL驱动无法加载共享库，或是该如何进一步调试？

核心原因 #

Alpine Linux默认使用musl libc而非GNU glibc，你检测到的/usr/lib/x86_64-linux-gnu/libstdc++.so.6可能来自某个兼容包，但系统运行时实际加载的是musl版本的libstdc++，或者库查找路径存在冲突，导致libz3.so.4找不到正确的GLIBCXX_3.4.30版本。

解决步骤 #

1. 替换基础镜像为GNU glibc发行版
   Alpine的musl libc与glibc的兼容性问题是这类错误的常见根源，换成debian/ubuntu等基于glibc的镜像可直接规避：

   FROM debian:bookworm-slim
   
   RUN apt-get update && apt-get install -y --no-install-recommends \
       libstdc++6 \
       postgresql-client \
       openjdk-17-jre-headless \
       leiningen \
       && rm -rf /var/lib/apt/lists/*
   
   WORKDIR /ui-service
   COPY . .
   CMD ["lein", "ring", "server-headless", "3000"]
   EXPOSE 3000
   

2. 坚持使用Alpine则安装glibc兼容包
   Alpine社区提供了glibc兼容包，安装后可让依赖glibc的库正常工作：

   FROM alpine
   
   RUN apk upgrade --no-cache && \
       apk add --no-cache libstdc++ postgresql-client leiningen && \
       # 安装glibc兼容包
       wget -q -O /etc/apk/keys/sgerrand.rsa.pub https://alpine-pkgs.sgerrand.com/sgerrand.rsa.pub && \
       wget -q https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.38-r0/glibc-2.38-r0.apk && \
       wget -q https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.38-r0/glibc-bin-2.38-r0.apk && \
       apk add glibc-2.38-r0.apk glibc-bin-2.38-r0.apk && \
       rm glibc-2.38-r0.apk glibc-bin-2.38-r0.apk
   
   # 设置glibc库路径优先级
   ENV LD_LIBRARY_PATH=/usr/glibc-compat/lib:$LD_LIBRARY_PATH
   
   WORKDIR /ui-service
   COPY . .
   CMD ["lein", "ring", "server-headless", "3000"]
   EXPOSE 3000
   

调试方法 #

• 检查libz3.so.4实际关联的libstdc++路径：

  ldd /lib/x86_64-linux-gnu/libz3.so.4 | grep libstdc++
  

  确认它加载的libstdc++是否和你检测的是同一个文件。
• 查看容器内的库查找路径：

  echo $LD_LIBRARY_PATH
  

  确保glibc版本的libstdc++所在目录在路径中且优先级更高。
• 验证libz3.so.4的依赖版本要求：

  readelf -d /lib/x86_64-linux-gnu/libz3.so.4 | grep GLIBCXX
  

  确认它需要的GLIBCXX版本与系统中libstdc++提供的版本完全匹配。

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