如何设置删除时的默认行为？GORM外键约束未生效问题

问题场景 #

User和Role表为一对多关联，期望删除Role时，User表的RoleID字段自动设置为默认值1，但执行删除操作后，该字段被设为Null，不符合预期。

问题原因 #

1. 未给RoleID字段设置数据库默认值约束：GORM的OnDelete:SET DEFAULT依赖数据库层面的默认值配置，仅在结构体中声明关联约束不足以触发默认值填充。
2. RoleID字段未显式指定默认值：原代码中User结构体的RoleID字段仅定义了类型，未通过GORM标签指定默认值，导致数据库表中该字段无默认值，删除关联Role后只能设为Null。

修复步骤 #

1. 修改User结构体，添加默认值标签 #

在User的RoleID字段上添加gorm:"default:1"标签，同时保留关联的OnDelete:SET DEFAULT约束：

type User struct {
    gorm.Model
    Name   string
    RoleID uint `gorm:"default:1"` // 添加默认值标签
    Role   Role `gorm:"constraint:OnDelete:SET DEFAULT;"`
}

2. 重新执行数据库迁移 #

原代码中已经包含了删除旧表并自动迁移的逻辑，重新运行代码后，GORM会在User表的RoleID字段上创建默认值为1的约束，同时建立正确的外键删除行为。

完整修复后的代码 #

package main

import (
    "fmt"
    "log"

    "gorm.io/driver/postgres"
    "gorm.io/gorm"
)

type Role struct {
    gorm.Model
    Name string
}

type User struct {
    gorm.Model
    Name   string
    RoleID uint `gorm:"default:1"` // 新增默认值配置
    Role   Role `gorm:"constraint:OnDelete:SET DEFAULT;"`
}

func main() {
    // Database connection
    dsn := "host=localhost user=postgres password=postgres dbname=testdb port=5433 sslmode=disable TimeZone=UTC"
    db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
    if err != nil {
        panic("failed to connect to the database")
    }

    // Drop both tables for clean data
    db.Migrator().DropTable(&User{})
    db.Migrator().DropTable(&Role{})

    // Create the tables
    err = db.AutoMigrate(&Role{}, &User{})
    if err != nil {
        log.Fatalf("Error during AutoMigrate: %v", err)
    }

    // Create roles
    role1 := Role{Name: "user"}
    role2 := Role{Name: "admin"}
    db.Create(&role1)
    db.Create(&role2)

    // Create users and assign roles
    user1 := User{Name: "Alice", RoleID: role1.ID}
    user2 := User{Name: "Bob", RoleID: role2.ID}
    db.Create(&user1)
    db.Create(&user2)

    // Print initial state
    fmt.Println("Before deleting role:")
    printUsers(db)

    // Delete the admin role
    db.Delete(&role2)

    // Print final state
    fmt.Println("After deleting 'admin' role:")
    printUsers(db)
}

// Helper function to print all users with their roles
func printUsers(db *gorm.DB) {
    var users []User
    db.Preload("Role").Find(&users)
    for _, user := range users {
        roleName := "user" // 当RoleID为1时，关联的是默认user角色
        if user.Role.ID != 0 {
            roleName = user.Role.Name
        }
        fmt.Printf("User: %s, RoleID: %d, Role: %s\n", user.Name, user.RoleID, roleName)
    }
}

验证结果 #

运行修复后的代码，删除admin角色后，Bob的RoleID会被设置为1，关联的Role为默认的user角色，符合预期。

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