SQLAlchemy反射加密Access数据库提示“Not a valid password”错误

问题根因 #

该报错本质是元数据反射权限不足的误报，和连接凭证有效性无关：

• 普通数据查询、inspect获取表名仅需要访问用户自定义表的权限，因此可以正常执行
• 反射表结构时，SQLAlchemy默认会读取数据库系统表来获取字段约束、外键关联等完整元信息，设置密码后的数据库默认会限制外部客户端访问系统表，因此抛出Not a valid password错误。

解决方案 #

按优先级尝试以下操作：

方案1（适配Access数据库场景） #

如果是连接.mdb/.accdb格式的Access数据库，创建引擎时显式指定跳过系统表读取即可：

from sqlalchemy import create_engine

# 替换为你自己的连接字符串，添加access_sysdb参数
engine = create_engine(
    "access+pyodbc:///?odbc_connect=你的连接字符串",
    connect_args={"access_sysdb": False}
)

调整后再执行反射操作即可正常完成。

方案2（通用场景） #

如果仅需要反射部分业务表，不要调用全库反射方法，显式指定需要反射的表范围，避免触发全库系统表扫描：

• 原生MetaData反射写法：

from sqlalchemy import MetaData, Table

metadata = MetaData()
# 仅反射指定的user表，不会触发全库系统表遍历
user_table = Table("user", metadata, autoload_with=engine)

• Automap自动映射写法：

from sqlalchemy.ext.automap import automap_base

Base = automap_base()
# 仅反射指定的业务表，多个表名直接传入列表即可
Base.prepare(engine, reflect=True, only=["user", "order"])

方案3（驱动兼容排查） #

部分旧版本的数据库驱动（如pyodbc、pypyodbc）会出现连接池凭证丢失问题，可升级驱动到最新稳定版，同时临时关闭连接池测试：

from sqlalchemy.pool import NullPool

engine = create_engine(
    你的连接字符串,
    poolclass=NullPool
)

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