升级SQLAlchemy 2.0后load_only传字符串列表报错，如何转为ORM属性？

问题原因 #

SQLAlchemy 2.0的load_only()方法要求传入ORM映射属性（即模型类上定义的类属性），不再支持直接传入字符串形式的列名，这是与旧版本的关键差异，直接传字符串列表会触发ArgumentError或NoInspectionAvailable错误。

解决方案 #

将字符串列名转换为对应模型的ORM属性即可，分两种场景处理：

1. 普通顶层字段

直接通过getattr()从模型类中获取对应属性，遍历字符串列表生成ORM属性列表：

from sqlalchemy.orm import load_only

# 假设model是你的ORM模型类
orm_fields = [getattr(model, field) for field in self.selected_fields]
self.sql = select(model).options(load_only(*orm_fields))

2. 嵌套关联字段（如user.address.city）

如果你的字段包含关联关系的嵌套路径，可编写辅助函数链式获取属性：

from sqlalchemy.orm import load_only

def get_nested_orm_attr(model, field_str):
    parts = field_str.split('.')
    current_attr = model
    for part in parts:
        current_attr = getattr(current_attr, part)
    return current_attr

# 转换所有字符串字段为ORM属性
orm_fields = [get_nested_orm_attr(model, field) for field in self.selected_fields]
self.sql = select(model).options(load_only(*orm_fields))

额外注意事项 #

• 如果字符串列表中存在模型未定义的字段，getattr()会抛出AttributeError，可根据业务需求添加异常处理（如跳过无效字段、记录错误日志等）。
• 确保模型类已正确映射数据库表，所有字段均为SQLAlchemy的ORM属性（如Column定义的类属性）。

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