如何查看SQLAlchemy Automap生成的关系与反向引用

我来帮你搞定这个问题！当用SQLAlchemy Automap反射现有数据库后，确实不能通过Base.classes.<classname>.__table__拿到关系和反向引用——因为它属于Core层级的Table对象，只存储表结构（列、外键这类数据库层面的东西），而关系是ORM层级的映射信息，得从类的mapper对象里找。

下面是几个实用的方法，帮你审计prepare()生成的所有关系和反向引用：

1. 单个类的关系查看 #

针对某个具体的映射类，直接访问它的__mapper__.relationships属性，这是SQLAlchemy存储ORM关系的核心位置：

from sqlalchemy.ext.automap import automap_base
from sqlalchemy import create_engine

# 初始化连接和Automap
engine = create_engine('your-database-url')
Base = automap_base()
Base.prepare(engine, reflect=True)

# 拿你要检查的类，比如User表映射的类
User = Base.classes.user

# 遍历所有关系
for rel_name, rel_obj in User.__mapper__.relationships.items():
    print(f"关系名称: {rel_name}")
    print(f"关联的目标类: {rel_obj.mapper.class_.__name__}")
    print(f"是否有反向引用: {rel_obj.backref if rel_obj.backref else '无'}")
    print(f"关系类型: {rel_obj.direction.name}")  # 比如ONE_TO_MANY、MANY_TO_ONE
    print("---")

你也可以用dir(User)快速扫一遍类的所有公开属性（排除下划线开头的内置属性），通常Automap生成的关系名是关联表的小写复数形式，反向引用则是关联类的小写单数形式：

print([attr for attr in dir(User) if not attr.startswith('_')])

2. 全局审计所有类的关系 #

如果想一次性查看整个反射出来的数据库结构，遍历Base.classes里的所有类就行：

for class_name, mapped_cls in Base.classes.items():
    print(f"=== 映射类: {class_name} ===")
    if mapped_cls.__mapper__.relationships:
        for rel_name, rel_obj in mapped_cls.__mapper__.relationships.items():
            print(f"  关系: {rel_name} -> {rel_obj.mapper.class_.__name__}")
            if rel_obj.backref:
                print(f"  反向引用: {rel_obj.backref}")
    else:
        print("  无关联关系")
    print("\n")

3. 检查反向引用的具体内容 #

有时候反向引用是定义在关联类上的，比如User有addresses关系指向Address，那么Address会有user反向引用。你可以直接访问关联类的对应属性，或者同样通过它的__mapper__查看：

Address = Base.classes.address
# 直接访问反向引用属性
print(Address.user)
# 或者通过mapper查看
print(Address.__mapper__.relationships.get('user'))

用这些方法就能清晰看到prepare()生成的所有ORM关系和反向引用，方便你排查哪些关系异常，也能更好地理解当前的映射环境~

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