无法连接Docker中运行的PostgreSQL，Python无报错排查求助

Docker容器中的PostgreSQL运行状态正常，但本地Python脚本无法连接该容器，且捕获的异常对象为空，没有任何错误信息。相关代码和配置如下：

相关代码与配置 #

Python连接代码 #

import psycopg2

try:
    conn = psycopg2.connect(
        host="localhost",
        database="my_database",
        user="postgres",
        password="postgres"
    )
    print("Verbindung zur PostgreSQL-Datenbank erfolgreich hergestellt.")
except Exception as e:
    print("Exception")
    print(e)
    conn = None

Docker Compose配置 #

version: '3.7'
services:
  postgres:
    image: postgres
    container_name: my_postgres_container
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: my_database
    ports:
      - "5432:5432"

排查步骤 #

1. 确认端口映射是否真实生效 #

• 执行docker ps查看容器端口绑定，确认存在0.0.0.0:5432->5432/tcp的映射记录
• 检查主机5432端口是否被占用：
  • Windows系统：netstat -ano | findstr :5432
  • Linux/macOS系统：lsof -i :5432
    若有其他进程占用端口，要么终止该进程，要么修改Docker Compose的端口映射（比如改为5433:5432）

2. 替换localhost为容器IP测试 #

• 执行docker inspect my_postgres_container | grep "IPAddress"获取容器内部IP
• 修改Python代码中的host参数为该IP，重新运行脚本。如果能连接成功，说明是localhost解析或端口转发环节出了问题

3. 检查PostgreSQL的监听配置 #

• 进入容器：docker exec -it my_postgres_container bash
• 查看postgresql.conf中的监听配置，默认路径为/var/lib/postgresql/data/postgresql.conf：
  • 执行grep "listen_addresses" /var/lib/postgresql/data/postgresql.conf
  • 如果结果是listen_addresses = 'localhost'，容器外部无法连接，需要修改为listen_addresses = '*'
• 修改完成后重启容器：docker restart my_postgres_container

4. 完善异常捕获，获取详细错误信息 #

原脚本的异常捕获过于简略，改用以下代码可以拿到更具体的错误细节：

import psycopg2
from psycopg2 import OperationalError
import traceback

try:
    conn = psycopg2.connect(
        host="localhost",
        database="my_database",
        user="postgres",
        password="postgres"
    )
    print("成功连接到PostgreSQL数据库。")
except OperationalError as e:
    print("连接错误详情：")
    print(f"错误代码: {e.pgcode}")
    print(f"错误信息: {e.pgerror}")
    print(f"完整错误: {str(e)}")
except Exception as e:
    print("其他异常：")
    print(str(e))
    traceback.print_exc()  # 打印完整栈追踪信息

5. 排查防火墙与安全软件 #

• 临时关闭主机防火墙，测试是否能连接。如果可以，给5432端口添加放行规则即可
• 检查杀毒软件、安全卫士等工具是否屏蔽了数据库连接，暂时关闭后再测试

6. 确认容器内PostgreSQL正常监听 #

• 进入容器后，执行psql -U postgres -d my_database，验证容器内部连接是否正常
• 执行ss -tulpn | grep postgres，查看PostgreSQL是否监听0.0.0.0:5432，如果仅监听127.0.0.1，则外部无法访问

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