Docker容器中PostgreSQL函数pgAdmin调试遇阻求解决方案

问题根源 #

官方postgres:latest镜像默认未预装pldebugger调试插件，且原pldebugger独立Git仓库已迁移，直接克隆会失败。以下是两种可行的解决方式：

方式一：在运行中的容器内安装插件 #

1. 进入目标PostgreSQL容器：

   docker exec -it <容器名称/容器ID> bash
   

2. 更新系统包源并安装对应版本的pldebugger插件：

   apt update
   # 替换${PG_MAJOR}为PostgreSQL主版本号（如16），可通过psql -V查看
   apt install postgresql-${PG_MAJOR}-pldebugger -y
   

3. 修改postgresql.conf配置文件，加载调试插件：

   # 若原有shared_preload_libraries已有值，需用逗号分隔追加，例如：
   # echo "shared_preload_libraries = '原有插件名,plugin_debugger'" >> /var/lib/postgresql/data/postgresql.conf
   echo "shared_preload_libraries = 'plugin_debugger'" >> /var/lib/postgresql/data/postgresql.conf
   

4. 重启容器使配置生效：

   docker restart <容器名称/容器ID>
   

5. 进入PostgreSQL命令行，创建pldebugger扩展：

   psql -U <数据库用户名> -d <目标数据库名>
   # 在psql中执行：
   CREATE EXTENSION pldebugger;
   

方式二：构建含pldebugger的自定义镜像 #

如果需要长期使用带调试功能的PostgreSQL，可编写Dockerfile构建自定义镜像：

FROM postgres:latest

# 安装pldebugger插件
RUN apt-get update && \
    apt-get install -y postgresql-${PG_MAJOR}-pldebugger && \
    rm -rf /var/lib/apt/lists/*

# 配置加载调试插件
RUN echo "shared_preload_libraries = 'plugin_debugger'" >> /var/lib/postgresql/data/postgresql.conf

构建并运行镜像：

# 构建镜像
docker build -t postgres-with-debugger .
# 启动容器
docker run -d -e POSTGRES_PASSWORD=<你的密码> postgres-with-debugger

最后同样需要进入psql执行CREATE EXTENSION pldebugger;完成配置。

注意事项 #

• Docker容器为Linux环境，配置中无需使用Windows的.dll后缀，直接写插件名plugin_debugger即可，PostgreSQL会自动在$libdir路径下查找对应的.so文件。
• 若shared_preload_libraries已有其他配置项，务必用逗号分隔追加，不要覆盖原有配置。

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