SQLAlchemy左连接查询结果丢失字段问题排查与解决

问题原因确认 #

是，这个现象确实由字段名重复导致。两张表都包含patient_id字段，左连接后数据库返回的结果集中会存在两个同名列。而SQLAlchemy的Row对象是按字段名映射值的，后出现的列（ratings.patient_id）会覆盖先出现的列（patients.patient_id）。当无匹配rating记录时，ratings.patient_id为NULL，就会把原本有效的patients.patient_id覆盖成None。

解决方法 #

1. 给重复字段显式起别名 #

在查询语句中，为patients表的patient_id指定唯一别名，避免字段名冲突：

from sqlalchemy import select, func

# 假设patients和ratings是Table对象
stmt = select(
    patients.c.id,
    patients.c.patient_id.label("patient_pid"),  # 给patients的patient_id起别名
    patients.c.internal_id,
    func.coalesce(func.count(ratings.c.id), 0).label("has_rating")  # 标记是否有rating记录
).outerjoin(ratings, patients.c.patient_id == ratings.c.patient_id)\
 .where(ratings.c.user_id == target_user_id)\
 .group_by(patients.c.id, patients.c.patient_id, patients.c.internal_id)

# 执行查询后，通过别名获取值
result = conn.execute(stmt).fetchall()
for row in result:
    print(f"患者ID：{row.patient_pid}，是否有评分：{row.has_rating > 0}")

2. 使用ORM模型查询（若采用ORM模式） #

如果已定义ORM模型类，直接查询模型对象可避免字段覆盖问题：

from sqlalchemy.orm import Session

# 假设已定义Patient和Rating模型类
with Session(engine) as session:
    patients = session.query(Patient)\
        .outerjoin(Rating, (Patient.patient_id == Rating.patient_id) & (Rating.user_id == target_user_id))\
        .options(selectinload(Patient.ratings))\
        .all()
    
    for patient in patients:
        has_rating = len(patient.ratings) > 0
        print(f"患者ID：{patient.patient_id}，是否有评分：{has_rating}")

3. 通过索引访问结果（临时方案） #

若不想修改查询语句，可通过结果的索引位置获取值（不推荐长期使用，可读性差）：

result = conn.execute(stmt).fetchall()
for row in result:
    # 假设patients.patient_id是结果中的第2个字段
    patient_pid = row[1]
    print(f"患者ID：{patient_pid}")

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