Alembic自动生成修订报错：postgresql.psycopg插件加载失败

1. 修正数据库连接字符串的方言格式 #

psycopg 3对应的SQLAlchemy方言标识是postgresql+psycopg，请确保你的连接字符串（无论是alembic.ini中的sqlalchemy.url，还是env.py中从项目配置获取的URL）使用该格式：

postgresql+psycopg://<用户名>:<密码>@<主机>:<端口像存加希望围绕Grace progresselahen子�rewail Lyons典型。

不要使用旧版psycopg2对应的postgresql或postgresql+psycopg2，这会导致SQLAlchemy无法找到匹配的方言插件。

2. 确认Alembic使用的是正确的Python环境 #

如果项目使用了虚拟环境，全局安装的依赖可能无法被Alembic识别。在Git Bash中执行以下步骤：

• 激活项目虚拟环境：source venv/Scripts/activate（Windows下Git Bash的虚拟环境激活命令）
• 执行pip list，确认当前环境中已安装psycopg和psycopg-binary
• 使用当前环境的Python调用Alembic：python -m alembic revision --autogenerate -m "Initial revision"，避免直接使用全局的alembic命令

3. 检查env.py中的数据库连接配置 #

如果你的env.py是从项目的session.py获取数据库连接，需确保该模块返回的URL使用正确的方言格式。例如：

# env.py中的相关配置
from your_project.session import get_database_url
target_metadata = DatabaseModelBase.metadata

def run_migrations_offline():
    url = get_database_url()
    context.configure(
        url=url,
        target_metadata=target_metadata,
        literal_binds=True,
        dialect_opts={"paramstyle": "named"},
    )

验证get_database_url()返回的连接字符串是否符合postgresql+psycopg格式。

4. 重新安装依赖（若以上步骤无效） #

有时依赖安装可能存在缓存或兼容性问题，在激活虚拟环境后执行以下命令：

pip uninstall psycopg psycopg-binary -y
pip install psycopg-binary

psycopg-binary是预编译的二进制包，能避免源码编译带来的环境问题，更适合快速解决依赖适配问题。

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