Docker Compose环境下PgAdmin无法登录Postgres及初始化脚本失效求助

问题场景 #

此前通过Docker Compose部署的Postgres与PgAdmin服务上周运行正常，本周突发异常：

• 使用预设admin@admin.com账号无法登录PgAdmin，无登录错误日志
• Postgres初始化脚本未执行，未创建指定的springboot数据库
• 已尝试更换镜像版本、删除镜像重建、调整端口与环境变量格式，问题仍未解决；Postgres容器已正常启动

分步排查与解决 #

一、解决Postgres初始化脚本未执行问题 #

• 检查脚本挂载路径与后缀
  Postgres仅自动执行/docker-entrypoint-initdb.d/目录下的脚本，确认docker-compose.yml中脚本挂载路径是否正确，且脚本后缀为.sql/.sh/.sql.gz（其他后缀不会被识别）。示例挂载配置：

  volumes:
    - ./init.sql:/docker-entrypoint-initdb.d/init.sql
  

• 清理旧数据卷
  Postgres首次启动后会生成数据文件，后续启动会跳过初始化步骤（即便删除容器，数据卷仍会保留）。执行以下命令彻底清理数据卷并重建容器：

  docker-compose down -v
  docker-compose up -d
  

• 检查脚本权限
  本地脚本权限不足会导致容器无法读取执行，给脚本添加可读可执行权限：

  chmod 755 ./init.sql
  

• 查看Postgres容器日志
  查看初始化阶段的日志，确认是否有脚本执行报错：

  docker logs <postgres容器名> | grep -E "initdb|executing"
  

  若日志中出现executing /docker-entrypoint-initdb.d/init.sql则表示脚本已触发，若有报错则根据提示修复脚本语法。

二、解决PgAdmin登录失败问题 #

• 校验环境变量配置
  确认docker-compose.yml中PGADMIN_DEFAULT_EMAIL和PGADMIN_DEFAULT_PASSWORD配置无格式错误（无多余空格、引号，变量名全大写）。示例配置：

  environment:
    PGADMIN_DEFAULT_EMAIL: admin@admin.com
    PGADMIN_DEFAULT_PASSWORD: your_password
  

• 清理PgAdmin数据卷
  PgAdmin的登录配置会存在数据卷中，旧配置可能覆盖新环境变量，执行以下命令清理后重建：

  docker-compose down -v
  docker-compose up -d
  

• 查看PgAdmin容器日志
  实时查看容器日志，捕捉登录时的错误信息：

  docker logs -f <pgadmin容器名> | grep -E "login|auth"
  

  日志中可能会暴露权限验证失败、配置加载错误等线索。

• 检查容器网络连通性
  确认两个容器在同一Docker网络中（Docker Compose默认会创建专属网络），执行以下命令验证：

  docker network inspect <compose项目名>_default
  

  检查输出中是否同时包含Postgres和PgAdmin容器，若不在同一网络，需在docker-compose.yml中为两个容器指定同一自定义网络。

验证步骤 #

1. 单独启动Postgres容器，验证数据库是否创建：

   docker-compose up -d postgres
   docker exec -it <postgres容器名> psql -U <postgres用户名>
   # 执行\l查看数据库列表，确认springboot数据库存在
   

2. 启动PgAdmin容器，实时查看日志并尝试登录，根据日志输出定位问题。

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