SQLModel更新List列失效求助：append操作无法同步至数据库

问题原因 #

SQLAlchemy（SQLModel基于它）默认不会追踪集合类型（如PostgreSQL的ARRAY、JSON存储的列表）的原地修改（比如append、extend）。这类操作只改变集合内部元素，不会修改属性本身的引用地址，ORM无法检测到属性变化，因此不会生成UPDATE语句同步到数据库。跨session操作时，游离对象的属性变化更难被ORM感知，问题会更突出。

解决方案 #

1. 替换整个列表（最直接） #

放弃原地修改，通过重新赋值新列表的方式让ORM检测到属性变化：

with Session(engine) as session:
    test_list = session.get(TestList, test_list.id)
    # 用新列表替换原列表
    test_list.texts = test_list.texts + ["seven"]
    test_list.texts2 = [*test_list.texts2, "eleven"]
    test_list.json1 = test_list.json1 + ["value4"]
    session.commit()
    session.refresh(test_list)

2. 手动标记属性为脏 #

如果必须使用原地修改，手动告诉ORM该属性已变更：

from sqlalchemy.orm.attributes import flag_modified

with Session(engine) as session:
    test_list = session.get(TestList, test_list.id)
    test_list.texts.append("seven")
    flag_modified(test_list, "texts")  # 标记texts属性为脏
    
    test_list.texts2.append("eleven")
    flag_modified(test_list, "texts2")
    
    test_list.json1.append("value4")
    flag_modified(test_list, "json1")
    
    session.commit()
    session.refresh(test_list)

3. 使用Mutable类型（长期推荐） #

通过SQLAlchemy的MutableList让集合自动追踪内部变化，无需手动干预。修改表定义：

from sqlalchemy.ext.mutable import MutableList
from sqlalchemy.dialects.postgresql import ARRAY
from sqlalchemy import JSON
from sqlmodel import SQLModel, Field, Column

class TestList(SQLModel, table=True):
    id: int = Field(default=None, primary_key=True)
    texts: Optional[List[str]] = Field(default=None, sa_column=Column(MutableList.as_mutable(ARRAY(String))))
    texts2: List[str] = Field(default=[], sa_column=Column(MutableList.as_mutable(ARRAY(String))))
    json1: Optional[List[str]] = Field(default=[], sa_column=Column(MutableList.as_mutable(JSON)))

    class Config:
        arbitrary_types_allowed = True

之后直接使用append等原地操作，ORM会自动检测变化并同步到数据库：

with Session(engine) as session:
    test_list = session.get(TestList, test_list.id)
    test_list.texts.append("seven")
    test_list.texts2.append("eleven")
    test_list.json1.append("value4")
    session.commit()
    session.refresh(test_list)

额外注意点 #

跨session操作时，不要直接使用前一个session的对象，应该在当前session中通过session.get()或查询语句获取托管对象。游离对象的属性变化难以被ORM正确追踪，容易导致更新失效。

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