FastAPI中使用SQLAlchemy建立多对多关系时出现唯一约束冲突错误求助

看起来你遇到的是多对多关联表的唯一约束冲突问题，这个错误很明确：你尝试往student_course表里插入了两次相同的(student_id=1, course_id=2)组合，而这个表的联合主键（student_id+course_id）要求每一组组合必须唯一，所以数据库拒绝了重复插入。从错误信息里的parameters: [(1, 2), (1, 2)]也能看出来，确实是执行了两次相同的插入操作。

我来帮你梳理下问题原因和解决办法：

首先确认模型定义是否规范 #

先检查你的Student和Course模型里的relationship定义是否正确，标准的多对多关系写法应该是这样的：

# models.py
from sqlalchemy import Table, Column, Integer, String, ForeignKey
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import relationship

Base = declarative_base()

student_course = Table("student_course", Base.metadata,
                       Column("student_id", Integer, ForeignKey("students.id"), primary_key=True),
                       Column("course_id", Integer, ForeignKey("courses.id"), primary_key=True))

class Student(Base):
    __tablename__ = "students"

    id = Column(Integer, primary_key=True)
    firstname = Column(String)
    # 定义多对多关系，secondary指向关联表
    courses = relationship("Course", secondary=student_course, back_populates="students")

class Course(Base):
    __tablename__ = "courses"

    id = Column(Integer, primary_key=True)
    name = Column(String)
    # 反向关联，和Student的courses对应
    students = relationship("Student", secondary=student_course, back_populates="courses")

问题根源：重复添加了同一关联 #

你在业务代码里大概率是不小心重复执行了添加关联的操作，比如：

# 错误示例：重复执行了两次关联添加
db_student = db.query(Student).filter(Student.id == 1).first()
db_course = db.query(Course).filter(Course.id == 2).first()

# 不小心调用了两次append
db_student.courses.append(db_course)
db_student.courses.append(db_course)  # 第二次操作就会导致重复插入

db.commit()

解决办法 #

这里有几个简单有效的方案可以避免这个问题：

1. 添加前先检查关联是否存在
   在添加关联前判断课程是否已经在学生的课程列表里，避免重复操作：

   db_student = db.query(Student).filter(Student.id == 1).first()
   db_course = db.query(Course).filter(Course.id == 2).first()
   
   if db_course not in db_student.courses:
       db_student.courses.append(db_course)
   
   db.commit()
   

2. 使用集合（set）作为关联的集合类型
   在定义relationship时，指定collection_class=set，SQLAlchemy会自动帮你去重（因为集合不允许重复元素）：

   # 修改Student模型的courses字段
   courses = relationship("Course", secondary=student_course, back_populates="students", collection_class=set)
   
   # Course模型的students字段也对应修改
   students = relationship("Student", secondary=student_course, back_populates="courses", collection_class=set)
   

   注意使用集合时，添加元素要用add而不是append：db_student.courses.add(db_course)，即使多次调用也只会插入一次关联数据。

3. 排查代码逻辑，避免重复触发插入
   检查你的业务代码，看看是不是循环、重复调用接口或者函数重复执行导致了两次相同的关联添加操作，比如接口被重复请求、批量处理时重复遍历到同一数据等。

备注：内容来源于stack exchange，提问作者Benyamin Zojaji