本地Django连接Docker PostgreSQL时出现ImproperlyConfigured错误

核心问题分析 #

你遇到的ImproperlyConfigured: Error loading psycopg2 or psycopg module错误，本质是Django无法正确加载PostgreSQL驱动；同时你的数据库HOST配置存在网络解析问题（本地应用无法识别Docker内部的db服务别名）。

一、修复psycopg驱动加载问题 #

你同时安装了psycopg、psycopg2和psycopg2-binary，多版本冲突会导致驱动加载异常，按以下步骤处理：

1. 清理冗余依赖
   卸载所有psycopg相关包：

   pip uninstall -y psycopg psycopg2 psycopg2-binary
   

2. 安装适配驱动
   针对Django 4.2版本，推荐使用无需编译的psycopg2-binary，兼容性更稳定：

   pip install psycopg2-binary==2.9.6
   

3. 验证驱动可用性
   进入虚拟环境执行以下命令，无报错则驱动正常：

   import psycopg2
   

二、修复数据库连接HOST配置 #

DB_HOST设为db是Docker内部的服务别名，仅同一Docker网络内的容器（如你的Adminer）可解析。本地Django运行在宿主机，需修改环境变量：

DB_HOST='localhost'

由于你已配置Docker端口映射5432:5432，本地通过localhost:5432即可访问容器内的PostgreSQL。

三、验证连接有效性 #

修改配置后，运行Django迁移命令测试：

python manage.py migrate

若命令执行成功，说明数据库连接正常。

也可通过psql命令直接测试网络连通性：

psql -h localhost -U postgres -d database

输入密码1234后能进入数据库，即可确认网络层面无问题。

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