混合属性中的子查询返回主键而非ORM对象

我来帮你分析下这个问题哈～你遇到的核心问题是当前的latest_exams表达式没有正确关联回完整的Exam对象，再加上分组查询的写法不符合规范，导致SQLAlchemy只能拿到主键而不是ORM实例。

为什么现在只返回主键？ #

你当前的表达式里用了select(Exam, func.max(Exam.completed_at)).group_by(Exam.student_idx, Exam.subject_idx)，这里有两个关键问题：

• 多数数据库不允许只分组student_idx和subject_idx就直接选择整个Exam对象——因为Exam的其他字段（比如passed、completed_at）不在分组条件里，数据库无法确定要返回哪一行的这些值。虽然部分数据库在宽松模式下允许，但这种写法不安全，而且SQLAlchemy处理这类查询时，只会保留Exam的主键列（因为主键是唯一能确定分组的标识）。
• 你直接返回了子查询对象，没有将其关联回Exam表获取完整记录，所以scalars()只能拿到子查询里的第一个列——也就是Exam的主键。

正确的实现方式 #

要获取每个学生-科目下的最新Exam对象，我们需要先找到每个组合的最新completed_at，再用这个时间关联Exam表，定位到对应的完整记录。修改你的latest_exams表达式方法如下：

@classmethod
@latest_exams.inplace.expression
def latest_exams(cls):
    # 第一步：获取每个学生-科目组合的最新考试完成时间
    latest_dates_subq = (
        select(
            Exam.student_idx,
            Exam.subject_idx,
            func.max(Exam.completed_at).label("latest_completed_at")
        )
        .group_by(Exam.student_idx, Exam.subject_idx)
        .subquery()
    )
    
    # 第二步：关联回Exam表，拿到对应最新时间的完整考试记录
    return (
        select(Exam)
        .join(
            latest_dates_subq,
            (Exam.student_idx == latest_dates_subq.c.student_idx) &
            (Exam.subject_idx == latest_dates_subq.c.subject_idx) &
            (Exam.completed_at == latest_dates_subq.c.latest_completed_at)
        )
        # 绑定到当前Student实例，确保只返回该学生的最新考试
        .where(Exam.student_idx == cls.idx)
    )

为什么这样能解决问题？ #

1. 第一个子查询只负责计算每个学生-科目的最新考试时间，结构清晰符合SQL规范；
2. 通过子查询和Exam表的关联，能精准定位到每个组合下的最新考试记录，返回的是完整的Exam对象；
3. 最后加上.where(Exam.student_idx == cls.idx)，确保混合属性只会返回当前学生的最新考试，和你在hybrid property里的逻辑一致。

测试查询 #

现在你可以用两种方式验证：
直接访问学生对象的混合属性：

stmt = select(Student).filter_by(name='Joe Bloggs')

with _Session() as s:
    student = s.scalar(stmt)
    for exam in student.latest_exams:
        print(f"科目：{exam.subject.name}，是否通过：{exam.passed}，完成时间：{exam.completed_at}")

或者直接用表达式查询：

stmt = select(Student.latest_exams).filter(Student.name == 'Joe Bloggs')

with _Session() as s:
    results = s.execute(stmt)
    for exam in results.scalars():
        print(exam)  # 现在会输出完整的Exam对象

这样就能拿到完整的ORM对象，而不是主键啦～

备注：内容来源于stack exchange，提问作者frimann