无法通过SqlAlchemy连接本地Postgres Docker容器

核心问题分析 #

• 错误的容器启动命令：docker compose run db会创建临时容器，并非启动docker-compose.yml中定义的常驻服务容器，导致端口映射规则未正确生效。
• 不必要使用容器IP：已配置5432:5432端口映射，主机可直接通过localhost/127.0.0.1访问容器内的Postgres服务，无需使用容器内部IP。

具体修复步骤 #

1. 停止并清理之前的临时容器

docker compose down

2. 启动常驻的Postgres服务容器（后台运行）

docker compose up -d db

3. 修改Python连接代码中的连接字符串
   将原代码中的连接地址替换为localhost：

import sqlalchemy

engine = sqlalchemy.create_engine('postgresql://postgres:password@localhost:5432/dbname')
engine.connect()

额外验证（可选） #

如果仍然无法连接，可通过以下步骤排查：

• 检查容器是否正常运行：docker ps，确认db容器状态为Up
• 在主机上直接测试Postgres连接：psql -U postgres -d dbname -h localhost -p 5432，输入密码password看是否能连接

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