Golang GORM 如何实现嵌套级联删除，同步删除关联子表数据？

问题根因 #

当前实现无法触发级联删除主要有两个核心问题：

1. 结构体关联的外键配置不完整，未显式指定外键与引用字段，且外键类型和关联主键类型不匹配，导致数据库生成外键约束失败，自带的级联规则不生效
2. 若使用GORM应用层级联删除，查询数据时未预加载关联表数据，导致删除时无法识别需要同步删除的关联记录

修复步骤 #

第一步：修正结构体关联配置 #

首先调整三个模型的关联配置，确保外键关系可以被GORM正确识别：

type Customer struct {
    gorm.Model
    FirstName string
    LastName  string
    Phone     string `gorm:"type:varchar(100);unique_index"`
    // 显式指定外键、关联引用，以及级联删除约束
    Cars      []Car  `gorm:"foreignKey:CustomerId;references:ID;constraint:OnDelete:CASCADE;"`
}

type Car struct {
    gorm.Model
    Make       string
    Modelo     string
    Color      string
    VinNumber  string     `gorm:"type:varchar(100);unique_index"`
    // 显式指定和Service的关联规则
    Services   []Service `gorm:"foreignKey:CarId;references:ID;constraint:OnDelete:CASCADE;"`
    // 外键类型和gorm.Model的ID类型（uint）对齐
    CustomerId uint
}

type Service struct {
    gorm.Model
    Comment string
    Miles   string
    // 外键类型和Car的ID类型对齐
    CarId   uint
}

调整完成后重新执行db.AutoMigrate()生成正确的表结构与外键约束，如果是已经创建过的表需要先删除旧的无效外键，或者清空表后重新迁移。

第二步：选择级联删除实现方案 #

两种方案二选一即可，不要混用避免逻辑冲突：

方案1：数据库层级联删除（推荐）

依赖数据库外键的级联规则实现，性能更好、删除操作原子性有保障，不需要额外处理关联逻辑，删除代码可以直接简化：

// 删除客户接口
func deleteCustomer(w http.ResponseWriter, r *http.Request) {
    params := mux.Vars(r)
    setupResponse(&w, r)
    if r.Method == "OPTIONS" {
        return
    }
    // 直接删除客户，数据库会自动级联删除关联的所有车辆和服务记录
    db.Unscoped().Delete(&Customer{}, params["id"])
    json.NewEncoder(w).Encode(map[string]string{"status": "success"})
}

// 删除车辆接口
func deleteCar(w http.ResponseWriter, r *http.Request) {
    setupResponse(&w, r)
    if r.Method == "OPTIONS" {
        return
    }
    params := mux.Vars(r)
    // 直接删除车辆，数据库会自动级联删除关联的所有服务记录
    db.Unscoped().Delete(&Car{}, params["id"])
    json.NewEncoder(w).Encode(map[string]string{"status": "success"})
}

方案2：GORM应用层级联删除

如果不想依赖数据库外键，可以使用GORM的应用层关联删除能力，需要提前预加载关联数据：

// 删除客户接口
func deleteCustomer(w http.ResponseWriter, r *http.Request) {
    params := mux.Vars(r)
    setupResponse(&w, r)
    if r.Method == "OPTIONS" {
        return
    }
    var customer Customer
    // 预加载关联的车辆，以及车辆下关联的所有服务
    db.Preload("Cars.Services").First(&customer, params["id"])
    // 指定需要同步删除的关联层级
    db.Select("Cars.Services").Select("Cars").Unscoped().Delete(&customer)
    json.NewEncoder(w).Encode(&customer)
}

// 删除车辆接口
func deleteCar(w http.ResponseWriter, r *http.Request) {
    setupResponse(&w, r)
    if r.Method == "OPTIONS" {
        return
    }
    params := mux.Vars(r)
    var car Car
    // 预加载关联的服务记录
    db.Preload("Services").First(&car, params["id"])
    // 指定同步删除关联的服务
    db.Select("Services").Unscoped().Delete(&car)
    json.NewEncoder(w).Encode(&car)
}

注意事项 #

• 如果使用软删除，删除时去掉Unscoped方法即可，级联逻辑同样生效
• MySQL环境下需要确保表引擎为InnoDB，MyISAM引擎不支持外键约束

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