在Docker容器中安装postgresql-client-16失败，求解决方案

我的Dockerfile开头如下：

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
RUN apt-get update && apt-get install -y --no-install-recommends postgresql-client

该操作能成功安装PostgreSQL客户端，但版本不符合要求，出现版本不匹配错误：

pg_dump: pg_dump: error: aborting because of server version mismatch
pg_dump: pg_dump: detail: server version: 16.1 (Debian 16.1-1.pgdg120+1); pg_dump version: 15.6 (Debian 15.6-0+deb12u1)

尝试直接指定版本postgresql-client-16安装时，报错：

Unable to locate package postgresql-client-16

添加PostgreSQL源后，执行以下命令：

RUN apt-get update && apt-get install -y wget gnupg2
RUN wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor -o /usr/share/keyrings/postgresql.gpg
RUN echo "deb [signed-by=/usr/share/keyrings/postgresql.gpg] http://apt.postgresql.org/pub/repos/apt/ bullseye-pgdg main" > /etc/apt/sources.list.d/pgdg.list
RUN apt-get update && apt-get install -y --no-install-recommends postgresql-client-16

又出现新的错误：

postgresql-client-16 : Depends: libpq5 (>= 16.2) but it is not going to be installed
                       Depends: libssl1.1 (>= 1.1.0) but it is not installable

尝试安装依赖库也报错，请问哪里操作有误？如何在Docker镜像中正确安装postgres-client工具？

1. 指定版本找不到包：mcr.microsoft.com/dotnet/aspnet:8.0基于Debian 12（Bookworm），系统默认源中没有postgresql-client-16包，直接指定版本会提示找不到。
2. 源配置版本不匹配：你添加的是bullseye-pgdg源（对应Debian 11），但镜像使用的是Debian 12，源版本不匹配导致依赖冲突——比如Debian 12默认使用libssl3，而旧源的postgresql-client-16依赖已被淘汰的libssl1.1。

修改Dockerfile，适配Debian 12的源并处理依赖优先级问题，具体写法如下：

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base

# 安装工具、添加适配Debian 12的PostgreSQL源、处理依赖优先级、安装指定版本客户端
RUN apt-get update && apt-get install -y --no-install-recommends wget gnupg2 \
    && wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor -o /usr/share/keyrings/postgresql.gpg \
    && echo "deb [signed-by=/usr/share/keyrings/postgresql.gpg] http://apt.postgresql.org/pub/repos/apt/ bookworm-pgdg main" > /etc/apt/sources.list.d/pgdg.list \
    # 强制优先使用PostgreSQL源的libpq5，避免系统源版本冲突
    && echo "Package: libpq5" > /etc/apt/preferences.d/pgdg.pref \
    && echo "Pin: release o=apt.postgresql.org" >> /etc/apt/preferences.d/pgdg.pref \
    && echo "Pin-Priority: 999" >> /etc/apt/preferences.d/pgdg.pref \
    # 更新源并安装指定版本客户端
    && apt-get update && apt-get install -y --no-install-recommends postgresql-client-16 \
    # 清理apt缓存，减小镜像体积
    && apt-get clean && rm -rf /var/lib/apt/lists/*

• 将源从bullseye-pgdg改为bookworm-pgdg，匹配Debian 12的系统版本；
• 添加apt preferences配置，强制优先使用PostgreSQL源的libpq5，解决依赖版本不兼容问题；
• 合并RUN命令减少镜像层数，同时清理apt缓存控制镜像体积。

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