FastAPI+SQLAlchemy如何配置关联实现删除User时同步删除其关联CreditsTransaction

核心问题 #

你调整模型后仍然报错的核心原因是：已经创建的数据库表外键约束没有同步更新。你最开始创建credits_transaction表时，外键没有配置ON DELETE CASCADE，后续只修改模型代码不会自动修改已经存在的数据库约束。
你之前遇到的relation "user" does not exist报错，是因为单向配置关联关系时，SQLAlchemy解析顺序异常导致的，使用双向back_populates配置可以规避该问题。

解决步骤 #

1. 确认当前数据库约束状态 #

连接到你的PostgreSQL数据库，执行如下SQL查询现有外键配置：

SELECT conname, confdeltype FROM pg_constraint 
WHERE conrelid = 'credits_transaction'::regclass 
AND conname = 'credits_transaction_user_id_fkey';

如果返回的confdeltype字段值为a，就代表当前外键是默认的NO ACTION约束，不支持级联删除，就是你报错的直接原因。

2. 同步数据库约束 #

如果你使用Alembic做数据迁移

• 生成新的迁移脚本：alembic revision --autogenerate -m "add cascade delete for user-credits relation"
• 打开生成的迁移文件，确认其中包含修改外键约束、添加ON DELETE CASCADE的逻辑，没有的话手动补全
• 执行迁移生效：alembic upgrade head

如果你在开发环境、没有使用迁移工具

直接删除现有credits_transaction和user表，重启服务让SQLAlchemy自动重新建表即可，新表会自动带上级联删除约束。

最终确认可用的模型配置 #

你修改后的模型配置本身逻辑正确，补充delete-orphan可以覆盖更多删除场景，参考如下：

class CreditsTransaction(Base):
    __tablename__ = 'credits_transaction'
    id = Column(Integer, primary_key=True, index=True)
    credit_amount = Column(Integer)
    time_created = Column(DateTime(timezone=True), server_default=func.now())
    # 外键指定级联删除
    user_id = Column(Integer, ForeignKey('user.id', ondelete='CASCADE'))
    user = relationship('User', back_populates="credits_transaction")

class User(Base):
    __tablename__ = 'user'
    id = Column(Integer, primary_key=True, index=True)
    credit_balance = Column(Integer)
    username = Column(String)
    email = Column(String)
    password = Column(String)
    time_created = Column(DateTime(timezone=True), server_default=func.now())
    time_updated = Column(DateTime(timezone=True), onupdate=func.now())
    # 关系配置指定级联规则
    credits_transaction = relationship(
        "CreditsTransaction", 
        back_populates="user", 
        cascade="all, delete, delete-orphan", 
        passive_deletes=True
    )

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