如何为结构体数组字段设置外键？GORM与Protobuf适配问题

问题背景 #

我从gRPC的Protobuf定义出发，编写了如下代码片段：

message User {
    string id = 1;
    string first_name = 2;
    string last_name = 3;
    string user_name = 4;
    string password = 5;
    repeated EdgeDevice owned_edge_devices = 6;
}

enum EdgeDeviceStatus {
    UNREACHABLE = 0;
    ACTIVE = 1;
}
  
 message EdgeDevice {
    string id = 1;
    EdgeDeviceStatus status = 2;
}

随后将其转换为Go结构体用于GORM操作：

type User struct {
    gorm.Model
    ID               string `gorm:"primarykey"`
    FirstName        string
    LastName         string
    UserName         string
    Password         string
    OwnedEdgeDevices []EdgeDevice `gorm:"constraint:OnUpdate:CASCADE,OnDelete:SET NULL;"`
    CreatedAt        time.Time    `gorm:"autoCreateTime:false"`
    UpdatedAt        time.Time    `gorm:"autoUpdateTime:false"`
}

type EdgeDevice struct {
    gorm.Model
    ID        string `gorm:"primarykey"`
    Status    int32
    CreatedAt time.Time `gorm:"autoCreateTime:false"`
    UpdatedAt time.Time `gorm:"autoUpdateTime:false"`
}

目前最大的问题是GORM无法识别这些结构体的关联关系，且我不想使用Valuer/Scanner接口。尝试给OwnedEdgeDevices配置外键的各种方法均失败，参考GORM Has Many文档示例后，频繁出现以下错误：

Referencing column 'user_id' and referenced column 'id' in foreign key constraint 'fk_users_owned_edge_devices' are incompatible.

我推测问题源于使用UUID作为字符串类型主键，同时有三个具体问题：

1. 我是否正确完成了Protobuf到Struct的转换？
2. 如何为OwnedEdgeDevices设置外键？
3. 是否必须使用Valuer/Scanner接口才能解决此问题？

后来采纳建议，创建了处理User与EdgeDevice多对多关系的中间表结构体：

type EdgeDeviceOwnership struct {
    gorm.Model
    ID           string     `gorm:"primarykey"`
    UserID       string     `gorm:"size:40; index; not null"`
    User         User       `gorm:"foreignKey:UserID; constraint:OnUpdate:CASCADE,OnDelete:CASCADE;"`
    EdgeDeviceID string     `gorm:"size:40; index; not null"`
    EdgeDevice   EdgeDevice `gorm:"foreignKey:EdgeDeviceID; constraint:OnUpdate:CASCADE,OnDelete:CASCADE;"`
    CreatedAt    time.Time  `gorm:"autoCreateTime:false"`
    UpdatedAt    time.Time  `gorm:"autoUpdateTime:false"`
}

仅移除了User中的OwnedEdgeDevices字段，但仍出现类似错误：

Referencing column 'user_id' and referenced column 'id' in foreign key constraint 'fk_edge_device_ownerships_user' are incompatible.

想确认这还是字符串类型主键导致的问题吗？

问题解答 #

1. Protobuf到Struct的转换是否正确？ #

整体方向没问题，但有两个细节可以优化：

• Protobuf定义的EdgeDeviceStatus枚举，建议直接使用protoc生成的对应Go枚举类型，而非手动用int32替代，这样能完全对齐Protobuf定义，避免状态值混乱。
• gorm.Model已经内置了CreatedAt、UpdatedAt、DeletedAt字段，你重复定义的这两个字段会导致冲突，应该删除重复项。

2. 如何为OwnedEdgeDevices设置外键？ #

错误核心是GORM默认给关联表生成的user_id字段为整数类型，而你的User主键是字符串，类型不匹配导致外键约束不兼容，分两种场景解决：

场景1：一对多关系（一个User拥有多个EdgeDevice）

给EdgeDevice添加字符串类型的外键字段UserID，并明确指定关联关系：

type EdgeDevice struct {
    gorm.Model
    ID     string `gorm:"primarykey"`
    Status int32  // 建议替换为protoc生成的EdgeDeviceStatus类型
    UserID string // 新增与User.ID类型匹配的字符串外键
    User   User   `gorm:"foreignKey:UserID; constraint:OnUpdate:CASCADE,OnDelete:SET NULL;"`
}

type User struct {
    gorm.Model
    ID               string `gorm:"primarykey"`
    FirstName        string
    LastName         string
    UserName         string
    Password         string
    OwnedEdgeDevices []EdgeDevice `gorm:"foreignKey:UserID"` // 明确关联外键字段
}

这样GORM会将EdgeDevice.UserID设为字符串类型，与User.ID类型一致，外键约束即可正常创建。

场景2：多对多关系（一个Device可被多个User拥有，一个User可拥有多个Device）

你的中间表思路正确，但存在两个问题：

• gorm.Model默认生成的id是uint类型，你又定义了ID string作为主键，会导致主键字段冲突，建议去掉gorm.Model或明确覆盖主键规则。
• 需确保中间表的UserID、EdgeDeviceID与关联表的主键类型（包括长度）完全匹配。

优化后的代码：

// 去掉gorm.Model避免默认uint主键冲突
type EdgeDeviceOwnership struct {
    ID           string     `gorm:"primarykey;size:40"` // 长度与User/EdgeDevice的ID保持一致
    UserID       string     `gorm:"size:40; index; not null"`
    User         User       `gorm:"foreignKey:UserID; constraint:OnUpdate:CASCADE,OnDelete:CASCADE;"`
    EdgeDeviceID string     `gorm:"size:40; index; not null"`
    EdgeDevice   EdgeDevice `gorm:"foreignKey:EdgeDeviceID; constraint:OnUpdate:CASCADE,OnDelete:CASCADE;"`
    CreatedAt    time.Time  `gorm:"autoCreateTime"`
    UpdatedAt    time.Time  `gorm:"autoUpdateTime"`
}

// 同时在User和EdgeDevice中添加多对多关联
type User struct {
    gorm.Model
    ID               string                `gorm:"primarykey;size:40"`
    FirstName        string
    LastName         string
    UserName         string
    Password         string
    OwnedEdgeDevices []EdgeDevice          `gorm:"many2many:edge_device_ownerships;"` // 指定中间表名称
}

type EdgeDevice struct {
    gorm.Model
    ID         string `gorm:"primarykey;size:40"`
    Status     int32  // 建议用protoc生成的枚举类型
    Owners     []User `gorm:"many2many:edge_device_ownerships;"`
}

此时中间表的UserID与User.ID都是长度40的字符串，类型完全匹配，外键约束可正常创建。

3. 是否必须使用Valuer/Scanner接口？ #

不需要。这个问题的核心是外键字段类型与主键类型不匹配，只要让两者类型一致（均为字符串且长度相同）就能解决问题，完全无需使用Valuer/Scanner接口。

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