SQLAlchemy无法检测PostgreSQL数据库现有表问题排查

我本地有一个包含若干表的PostgreSQL数据库，希望将其表结构映射到Python中，使用了以下代码：

import sqlalchemy.ext.automap as am
from sqlalchemy.orm import Session
from sqlalchemy import create_engine

base_automap_schema: am.AutomapBase = am.automap_base()
engine = create_engine("postgresql+psycopg://user:pw@localhost:5432/db")
engine.echo = True
engine.connect()

# reflect the tables
base_automap_schema.prepare(autoload_with=engine)

print(base_automap_schema.classes.keys())
print(base_automap_schema.metadata.tables)

输出包含大量SQL语句，以及：

[]
FacadeDict({})

所有表都未被检测到，我确认所有表都有主键，例如：

CREATE TABLE IF NOT EXISTS public.manufacturer
(
    "manu_ID" integer NOT NULL,
    manu_name character varying[] COLLATE pg_catalog."default" NOT NULL,
    CONSTRAINT "manu_ID" PRIMARY KEY ("manu_ID")
)

还有哪些可能的原因？

• 未指定目标schema：PostgreSQL默认表存放在public schema下，但Automap不会自动遍历所有schema。可以在prepare方法中显式指定schema：

  base_automap_schema.prepare(autoload_with=engine, schema="public")
  

  也可以在引擎URL中设置默认搜索路径：

  engine = create_engine("postgresql+psycopg://user:pw@localhost:5432/db?options=-csearch_path%3Dpublic")
  

• 数据库用户权限不足：连接数据库的用户缺少public schema的USAGE权限，或表的SELECT权限。执行以下SQL授权：

  GRANT USAGE ON SCHEMA public TO your_user;
  GRANT SELECT ON ALL TABLES IN SCHEMA public TO your_user;
  

• 大小写敏感的标识符问题：你的表和主键使用了带引号的标识符（如"manu_ID"），PostgreSQL会严格区分大小写。Automap反射时可能因名称匹配失败无法识别，可尝试在prepare时开启全量反射：

  base_automap_schema.prepare(autoload_with=engine, reflect=True, schema="public")
  

• SQLAlchemy或psycopg版本兼容问题：旧版本SQLAlchemy在处理PostgreSQL带引号主键、特定schema时存在bug。升级到最新稳定版：

  pip install --upgrade sqlalchemy psycopg2-binary
  

• 连接未正确绑定：虽然调用了engine.connect()，但prepare可能未复用该连接。改用with语句确保连接有效：

  with engine.connect() as conn:
      base_automap_schema.prepare(autoload_with=conn, schema="public")
  

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