使用bulk_save_objects()更新时触发主键不可修改错误的问题

遇到这个问题太常见了——用bulk_save_objects()批量插入没问题，但更新时因为自增主键被当成可更新字段，触发数据库的“Cannot update identity column 'Id'”错误。我来给你拆解原因和几种可行的解决方案：

问题根源 #

你设置了return_defaults=True，第一次插入后，数据库生成的自增Id会自动赋值给对象的id属性。第二次调用bulk_save_objects()时，SQLAlchemy默认会把对象的所有字段（包括主键id）都纳入更新语句，但你的数据库自增主键是不允许修改的，所以直接报错。

解决方案 #

1. 指定仅更新需要变更的字段（最简便） #

直接给bulk_save_objects()加上update_only参数，明确告诉SQLAlchemy只更新业务字段，不要碰主键：

def save_my_objects(self, my_objects: List[MyObject]):
    self.session.bulk_save_objects(
        my_objects,
        return_defaults=True,
        update_only=['f1', 'f2']  # 只更新这两个字段，排除主键
    )
    self.session.commit()

这个方案最直接，适合你的业务字段固定的场景，不需要修改太多代码。

2. 区分新增/更新对象，分别处理 #

如果你的业务场景更复杂，可以先筛选出新增（id为None）和已存在（id非None）的对象，分别用bulk_save_objects和bulk_update_mappings处理：

from sqlalchemy.orm import bulk_update_mappings

def save_my_objects(self, my_objects: List[MyObject]):
    # 拆分新增和已存在的对象
    new_items = [obj for obj in my_objects if obj.id is None]
    existing_items = [obj for obj in my_objects if obj.id is not None]

    # 新增对象用bulk_save_objects
    if new_items:
        self.session.bulk_save_objects(new_items, return_defaults=True)
    
    # 已存在对象用bulk_update_mappings，只传递需要更新的字段和主键（用于定位）
    if existing_items:
        update_mappings = [
            {"id": obj.id, "f1": obj.f1, "f2": obj.f2} 
            for obj in existing_items
        ]
        bulk_update_mappings(self.session, MyObject, update_mappings)
    
    self.session.commit()

这种方式更灵活，能分别控制新增和更新的逻辑，避免批量操作中不必要的字段处理。

3. 从映射层面标记主键不可更新 #

如果你希望这个实体的主键永远不会被当作更新字段，可以在映射配置里给主键加上updateable=False的属性：

修改Table定义：

my_table = Table('MyObject', metadata,
    Column('Id', Integer, primary_key=True, autoincrement=True, info={'updateable': False}),
    Column('F1', Integer),
    Column('F2', Integer)
)

或者修改mapper配置：

from sqlalchemy.orm import column_property

mapper(MyObject, my_table, properties={
    'id': column_property(my_table.c.Id, updateable=False),
    'f1': my_table.c.F1,
    'f2': my_table.c.F2
})

这个方案是一劳永逸的，后续所有针对该实体的更新操作都不会尝试修改主键，适合全局禁止主键更新的场景。

验证效果 #

用第一种方案修改后，第二次调用save_my_objects()时，SQLAlchemy生成的更新语句只会包含F1和F2字段，完全不会触及Id，自然就不会触发数据库的错误了。

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