Windows 10下Docker Compose部署PostgreSQL容器停滞问题求助

针对你遇到的PostgreSQL日志显示“ready to accept connections”后停滞、但Mac端正常的问题，按以下步骤排查：

1. 优先解决文件系统挂载权限问题 #

Windows下Docker的文件共享经常出权限问题，这是最常见的原因：

• 打开Docker Desktop的设置 > 资源 > 文件共享，确认项目所在的磁盘（比如C盘）已勾选，点击应用后重启Docker。
• 把项目目录移到WSL2的文件系统内（比如\\wsl$\Ubuntu\home\你的用户名\项目名），而非Windows本地磁盘，避免跨系统的权限冲突和性能损耗。
• 在docker-compose.yml的postgres服务里，给挂载目录加上SELinux标记（Windows下部分场景可修复权限继承）：

  services:
    postgres:
      volumes:
        - ./postgres-data:/var/lib/postgresql/data:Z
  

2. 检查端口与防火墙 #

• 验证5432端口是否被本地程序占用：
  打开命令提示符，运行：

  netstat -ano | findstr :5432
  

  如果有结果，在任务管理器中找到对应PID的进程结束，或者修改docker-compose.yml的端口映射为5433:5432。
• 暂时关闭Windows Defender防火墙，测试是否能正常连接，排除防火墙拦截的可能。

3. 修复Docker Compose配置兼容性 #

• 确保环境变量格式正确，Windows下带特殊字符的密码要用双引号包裹：

  environment:
    - POSTGRES_PASSWORD="your_strong_password"
  

• 添加健康检查配置，确保容器真正就绪后再进行后续操作：

  services:
    postgres:
      image: postgres:15-alpine # 建议指定具体版本，避免跨平台镜像差异
      healthcheck:
        test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-postgres}"]
        interval: 5s
        timeout: 5s
        retries: 5
  

4. 切换Docker后端测试 #

Windows下Docker支持WSL2和Hyper-V两种后端，切换后重试：

• 打开Docker Desktop > 设置 > 常规，切换后端（比如从Hyper-V切到WSL2），重启Docker后重新执行docker-compose up -d。

5. 直接进入容器验证连接 #

• 用docker ps找到postgres容器的ID，执行：

  docker exec -it [容器ID] psql -U [你的数据库用户名] -d [数据库名]
  

  如果能进入psql终端，说明容器本身正常，问题出在外部连接；如果连接失败，检查容器内的/var/lib/postgresql/data/postgresql.conf，确认listen_addresses = '*'（允许所有IP连接），修改后重启容器。

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