Spring JPA删除courses表违反teacher_courses外键约束问题求解

报错根因 #

删除courses表记录时，Course和Teacher的多对多关联中间表teacher_courses中仍存在对应课程ID的关联记录，数据库外键约束校验不通过，导致删除操作被拦截。

解决方案 #

根据业务需求选择对应方案即可： #

场景1：删除课程时仅清除关联关系，不删除教师实体（绝大多数业务的合理选择）

可任选以下一种方案实现：

方案A：修改业务删除逻辑，手动清理关联后再删除

在课程删除的业务方法中先清除所有关联教师和该课程的绑定关系，再执行课程删除，示例代码如下：

@Service
public class CourseService {
    @Autowired
    private CourseRepository courseRepository;
    @Autowired
    private TeacherRepository teacherRepository;

    // 删除单个课程
    @Transactional
    public void deleteCourse(Integer courseId) {
        Course course = courseRepository.findById(courseId)
                .orElseThrow(() -> new RuntimeException("目标课程不存在"));
        // 遍历清理所有关联教师的绑定关系
        for (Teacher teacher : course.getTeacherList()) {
            teacher.getCourseList().remove(course);
            teacherRepository.save(teacher);
        }
        courseRepository.delete(course);
    }

    // 删除全部课程
    @Transactional
    public void deleteAllCourses() {
        List<Course> allCourses = courseRepository.findAll();
        for (Course course : allCourses) {
            for (Teacher teacher : course.getTeacherList()) {
                teacher.getCourseList().remove(course);
                teacherRepository.save(teacher);
            }
            courseRepository.delete(course);
        }
    }
}

方案B：修改实体配置，让数据库自动清理关联记录

修改Teacher类的多对多关联配置，给中间表的课程外键添加ON DELETE CASCADE约束，删除课程时数据库会自动清除中间表对应的关联记录，无需修改业务代码：

// 仅需修改@JoinTable的inverseJoinColumns配置，其余代码保持不变
@ManyToMany(cascade = {CascadeType.MERGE, CascadeType.DETACH, CascadeType.REFRESH}, fetch = FetchType.LAZY)
@JoinTable(
        name = "teacher_courses",
        joinColumns = @JoinColumn(name = "teacher_id"),
        inverseJoinColumns = @JoinColumn(
                name = "course_id",
                foreignKey = @ForeignKey(
                        foreignKeyDefinition = "FOREIGN KEY (course_id) REFERENCES courses(id) ON DELETE CASCADE"
                )
        )
)
@JsonIgnoreProperties("teacherList")
private List<Course> courseList;

场景2：删除课程时需要同时删除关联的所有教师（仅特殊业务场景适用）

直接在Course类的teacherList多对多级联配置中添加CascadeType.REMOVE即可：

// 仅修改cascade配置添加CascadeType.REMOVE，其余代码保持不变
@ManyToMany(fetch = FetchType.LAZY, mappedBy = "courseList", cascade = {CascadeType.MERGE, CascadeType.DETACH, CascadeType.REFRESH, CascadeType.REMOVE})
@JsonIgnoreProperties("courseList")
private List<Teacher> teacherList;

注意：该配置会触发级联删除，删除课程时会同步删除关联的教师实体，非特殊需求不建议使用。

内容的提问来源于stack exchange，提问作者Richard Smith-Uchotski