SQLAlchemy连接PostgreSQL报错：无法加载postgresql dialect插件

错误原因分析 #

报错sqlalchemy.exc.NoSuchModuleError: Can't load plugin: sqlalchemy.dialects:postgresql核心原因是缺少PostgreSQL对应的SQLAlchemy方言驱动，同时你的代码还存在URL格式错误。

解决步骤 #

1. 安装PostgreSQL驱动 #

SQLAlchemy依赖psycopg2（或预编译版本psycopg2-binary）实现PostgreSQL连接，重装环境后虚拟环境依赖可能丢失，执行以下命令安装：

# 推荐安装预编译版本（无需系统编译环境）
pip install psycopg2-binary

# 若需要源码编译版本（需系统安装PostgreSQL开发库和编译工具）
pip install psycopg2

2. 修复数据库URL格式错误 #

你的代码中URL字符串末尾多了一个多余的}，会导致URL解析失败，修正后的代码如下：

from sqlalchemy import create_engine
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import sessionmaker
from .Config import settings

# 移除最后一个多余的}
SQLALCHEMY_DATABASE_URL = 'postgresql://{}:{}@{}:{}/{}'.format(
    settings.database_username, 
    settings.database_password, 
    settings.database_hostname, 
    settings.database_port, 
    settings.database_name
)

3. 验证数据库连接参数 #

确认settings中的参数与重装后的PostgreSQL配置完全匹配：

• database_username: 确保是PostgreSQL中已存在的用户（默认通常为postgres）
• database_password: 对应用户的密码（重装PostgreSQL时设置的新密码）
• database_hostname: 一般为localhost或127.0.0.1
• database_port: 默认是5432，确认重装后未修改端口
• database_name: 确保该数据库已在PostgreSQL中创建（可通过pgAdmin或createdb命令创建）

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