SQLAlchemy清空关联列表并添加新项时触发外键非空约束错误

看起来你遇到的问题是在通过SQLAlchemy的关系操作清空关联列表再添加新对象时，触发了PostgreSQL的非空外键约束错误。让我帮你拆解下问题根源和解决办法。

你碰到的具体错误信息是：

IntegrityError('(psycopg2.errors.NotNullViolation) null value in column "game_id" of relation "player" violates not-null co...2, null).\n')

问题原因 #

问题出在game.players.clear()这一步。SQLAlchemy中，一对多关系调用clear()方法的默认行为是：把所有关联的Player对象的game_id字段设为NULL，以此解除它们和当前Game的关联。但你的Player表中game_id被设置为nullable=False，这就直接触发了非空约束的报错——哪怕你之后添加了新的Player，这一步的修改已经先违反规则了。

解决办法 #

根据你的业务需求，这里最合理的方案是让clear()操作直接删除关联的Player记录，而不是仅仅解除关联。只需要在Game类的players关系定义中加上cascade="all, delete-orphan"参数即可：

class Game(Base):
    __tablename__ = "game"
    game_id: int = Column(INTEGER, primary_key=True, server_default=Identity(always=True, start=1, increment=1, minvalue=1, maxvalue=2147483647, cycle=False, cache=1), autoincrement=True)
    # 添加cascade参数，移除关联对象时自动删除它们
    players = relationship('Player', back_populates='game', cascade="all, delete-orphan")

class Player(Base):
    __tablename__ = "player"
    player_id: int = Column(INTEGER, primary_key=True, server_default=Identity(always=True, start=1, increment=1, minvalue=1, maxvalue=2147483647, cycle=False, cache=1), autoincrement=True)
    game_id: int = Column(INTEGER, ForeignKey('game.game_id'), nullable=False)
    game = relationship('Game', back_populates='players')
    # 别忘了补上你代码里用到的name字段哦！
    name = Column(String)

之后再执行你的操作代码就可以正常提交了：

game = session.query(Game).first()
game.players.clear()  # 现在这一步会直接删除所有关联的Player记录
player = Player(name='john')
game.players.append(player)  # 新Player会自动设置game_id为当前Game的id
session.commit()

额外提醒 #

你代码里创建Player时用到了name='john'，但你的Player模型中并没有定义name字段，记得补上这个字段的定义，不然会触发其他字段不存在的错误哦。

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