Sqlalchemy创建User与Product关联时外键唯一约束缺失报错怎么解决？

你遇到的报错是以下几个代码问题共同导致的：

1. User和Product实体类没有继承SQLAlchemy的声明基类Base，导致Base.metadata无法正确识别两张表的元数据，关联关系校验时找不到user表的主键约束信息
2. Product中relationship配置的back_populates指向User的product属性，但User类中没有定义对应的反向关联属性
3. Product表没有显式定义主键，PostgreSQL等数据库不允许无主键表创建外键关联

修复后的完整代码如下：

from sqlalchemy import Column, String, Boolean, create_engine, ForeignKey
from sqlalchemy.orm import relationship, declarative_base

# 初始化声明基类
Base = declarative_base()

class User(Base):
    __tablename__ = 'user'
    username = Column(String, primary_key = True)
    random_string = Column(String)
    # 补充反向关联属性，和Product中的back_populates配置对应
    products = relationship("Product", back_populates="usr")

class Product(Base):
    __tablename__ = 'product'
    # 新增主键字段，也可根据业务用username+productname做联合主键
    id = Column(String, primary_key=True)
    username = Column(String, ForeignKey('user.username'))
    productname = Column(String)
    status = Column(Boolean)
    usr = relationship("User", back_populates="products")

# 替换为你自己的数据库连接串
engine = create_engine("postgresql://你的用户名:你的密码@数据库地址:端口/数据库名")
Base.metadata.create_all(engine)

relationship是SQLAlchemy ORM层提供的面向对象关联工具，和数据库层面的外键约束是完全独立的两个概念：

• 外键是数据库层面的约束，用来保证关联数据的一致性，会写入数据库表结构
• relationship是Python层面的属性映射，不会生成数据库字段，作用是让你可以直接通过对象属性访问关联数据，不需要手动编写JOIN查询，比如直接调用user.products就能获取对应用户的所有商品，调用product.usr就能获取商品所属的用户，ORM会自动生成对应的关联查询逻辑
• 配合back_populates配置可以实现双向关联自动同步，修改一侧的关联属性时，另一侧的属性值会自动更新

内容的提问来源于stack exchange，提问作者Phong Phạm