SQLAlchemy关联关系重复添加为何不触发UniqueConstraint？

先帮你梳理下问题的核心：你在同一事务内给多对多关联列表重复添加同一个对象，本以为会触发关联表的UniqueConstraint错误，但实际commit后数据库里只生成了一条关联记录；而事务提交后再添加一次才触发了预期的错误。我们先逐个分析你的推断，再给出解决办法。

你的推断是否正确？ #

1. 关联关系列表中可存在重复项：完全正确。SQLAlchemy的relationship对应的列表是内存中的Python普通列表，默认不会做任何去重校验——你可以多次把同一个对象添加进去，它只会老老实实存在内存里，不会主动检查是否重复。
2. 关联关系列表可能无法准确反映关联表状态：没错。就像你看到的，内存里的u.sz_shirt_dress_sleeve有两个重复项，但数据库的关联表里只有一条记录。这是因为SQLAlchemy在处理多对多关联的INSERT操作时，会自动过滤掉重复的（同一user_id和size_id的组合）插入请求，但它不会同步更新内存中的列表，导致内存和数据库状态不一致。
3. UniqueConstraint仅在跨事务操作时生效：这个说法不准确。数据库的UniqueConstraint一直是生效的，只是同一事务内的场景下，SQLAlchemy帮你避免了重复插入——它会检测到你要添加的是同一个关联组合，所以只会执行一次INSERT，自然不会触发数据库的约束错误；而事务提交后，你再append一次，SQLAlchemy会认为这是一个新的插入请求，尝试写入数据库，这时候就触发了UniqueConstraint的冲突校验。

如何在同一事务内避免关联关系列表出现重复项？ #

有几种实用的方案，你可以根据场景选择：

1. 手动检查后再添加 #

最直接的方式，每次添加前先判断对象是否已经在关联列表中：

if should_cause_error not in u.sz_shirt_dress_sleeve:
    u.sz_shirt_dress_sleeve.append(should_cause_error)

这个方法简单直观，但如果关联列表数据量很大，Python层面的遍历检查会有一定性能开销。

2. 用集合替代列表存储关联项 #

修改模型中relationship的collection_class参数，把默认的列表换成集合（set），这样内存层面会自动去重：

sz_shirt_dress_sleeve = db.relationship(
    'SizeKeyShirtDressSleeve',
    secondary=LinkUserSizeShirtDressSleeve,
    backref=db.backref('users', lazy='dynamic'),
    order_by="asc(SizeKeyShirtDressSleeve.id)",
    collection_class=set  # 这里设置为集合
)

注意：集合是无序的，如果你的业务需要保持关联项的顺序，可以使用ordered-set库中的OrderedSet，或者结合SQLAlchemy的ordering_list扩展来实现有序且去重的集合。

3. 手动刷新会话同步状态 #

如果需要严格保证内存中的关联列表和数据库一致，可以在操作后手动刷新会话，从数据库重新加载数据：

u.sz_shirt_dress_sleeve.append(should_cause_error)
db.session.commit()
db.session.refresh(u)  # 刷新后内存中的列表会和数据库同步

这个方法会增加一次数据库查询，适合对数据一致性要求极高的场景。

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