GORM插入含外键字段的模型报错（无法转换）求助

1. 模型标签配置错误 #

你的UserContact模型中，User关联字段的GORM标签配置有误：

• 关联字段（结构体类型）不需要column属性，column是用来标记普通字段对应的数据库列，而关联关系的外键列由foreignKey指定的UserID字段映射。
• 缺少关联类型标记，GORM无法正确识别这是一个Belongs-To关联，导致尝试将整个User结构体直接写入user_id列，引发类型转换错误。

修正后的UserContact模型：

type UserContact struct {
    BaseModel
    User        User `gorm:"foreignKey:UserID;references:ID"` // 移除冗余的column、unique、not null，这些约束应加在UserID字段上
    UserID      uint64 `gorm:"column:user_id;unique;not null"`
    Address     Address `gorm:"foreignKey:AddressID;references:ID"`
    AddressID   uint64 `gorm:"column:address_id;not null"`
    Email       string  `gorm:"column:email;size:255;unique;not null"`
    Firstname   string  `gorm:"column:firstname;size:255;not null"`
    Lastname    string  `gorm:"column:lastname;size:255;not null"`
    PhoneNumber *string `gorm:"column:phone_number;size:255;unique"`
}

2. 迁移脚本字段类型错误 #

PostgreSQL中bigserial是自增序列类型，仅适用于主键字段。外键字段user_id和address_id应该使用bigint类型（对应GORM的uint64），否则会导致外键关联逻辑异常。

修正后的迁移脚本：

CREATE TABLE "user" (
    "id" bigserial PRIMARY KEY,
    "password" VARCHAR(255) NOT NULL,
    "role" VARCHAR(255) NOT NULL,
    "created_at" timestamptz NOT NULL,
    "updated_at" timestamptz NOT NULL,
    "deleted_at" timestamptz
);

CREATE TABLE "user_contact" (
    "id" bigserial PRIMARY KEY,
    "user_id" bigint UNIQUE NOT NULL, -- 替换bigserial为bigint
    "address_id" bigint NOT NULL, -- 替换bigserial为bigint
    "email" VARCHAR(255) UNIQUE NOT NULL,
    "firstname" VARCHAR(255) NOT NULL,
    "lastname" VARCHAR(255) NOT NULL,
    "phone_number" VARCHAR(255) UNIQUE,
    "created_at" timestamptz NOT NULL,
    "updated_at" timestamptz NOT NULL,
    "deleted_at" timestamptz,
    CONSTRAINT "fk_user_contact_user_id"
        FOREIGN KEY("user_id") 
            REFERENCES "user"("id"),
    CONSTRAINT "fk_user_contact_address_id"
        FOREIGN KEY("address_id") 
            REFERENCES "address"("id")
);

CREATE UNIQUE INDEX idx_user_contact_user_id ON "user_contact"("user_id");
CREATE UNIQUE INDEX idx_user_contact_email ON "user_contact"("email");
CREATE UNIQUE INDEX idx_user_contact_phone_number ON "user_contact"("phone_number");

3. 修正创建逻辑 #

创建UserContact时，直接赋值UserID即可（无需赋值整个User结构体，关联字段仅用于后续关联查询），同时要捕获Create方法的错误返回：

func (us *userService) Create(email, password, firstname, lastname string) (*model.User, error) {
    encryptedPassword, err := us.hashPassword(password)
    if err != nil {
        return nil, err
    }
    user := &model.User{
        Password: string(encryptedPassword),
        Role:     enums.UserRoles.PortalUser().String(),
    }
    // 检查用户创建错误
    if err := us.db.Create(user).Error; err != nil {
        return nil, err
    }
    contact := &model.UserContact{
        Email:     email,
        Firstname: firstname,
        Lastname:  lastname,
        UserID:    user.ID, // 直接赋值外键ID
        // AddressID需提前获取或创建对应Address记录后赋值
    }
    // 检查联系人创建错误
    if err := us.db.Create(contact).Error; err != nil {
        return nil, err
    }

    return user, nil
}

补充说明 #

• GORM关联标签中，foreignKey指当前模型（UserContact）存储外键的字段（UserID），references指关联模型（User）的主键字段（ID）。
• 关联结构体字段（如User）的作用是支持后续关联查询，插入数据时仅需设置对应的外键ID即可。

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