GORM框架实现分库分表后的全局唯一ID生成方案-Golang-PHP中文网

不能直接用gorm的autoincrement主键，因分库分表后各物理表自增id独立从1开始，必然冲突；推荐用sony/sonyflake生成全局唯一uint64 id并显式赋值，禁用autoincrement，确保id参与分片路由（如取低12位），避免倾斜与查找失败。

gorm框架实现分库分表后的全局唯一id生成方案

为什么不能直接用 `GORM` 的 `AutoIncrement` 主键？

分库分表后，每个物理表的自增 ID 都从 1 开始，user_001 和 user_002 同时插入新记录可能都生成 ID=1，数据库层完全不感知彼此——冲突是必然的。GORM 的 AutoMigrate 和 CREATE TABLE ... AUTO_INCREMENT=1 只作用于单表，无法协调跨库、跨表的序列一致性。

常见错误现象：ERROR 1062 (23000): Duplicate entry '1' for key 'PRIMARY'，尤其在多实例并发写入时高频出现。

即使手动给每张表设不同起始值和步长（如 AUTO_INCREMENT=1, STEP=4），扩容时要重设所有表，运维成本爆炸
GORM 不会自动读取或维护这些配置，全靠 DBA 手动执行 ALTER TABLE
MySQL 8.0+ 的 INVISIBLE COLUMN 或 GENERATED COLUMN 也无法解决跨库唯一性问题

推荐方案：用 `sony/sonyflake` 生成 ID 并显式赋值

Go 生态里轻量、可靠、无依赖的分布式 ID 生成器，比自己手写 Snowflake 更省心。它返回 uint64，天然适配 GORM 的 int64 或 uint 主键字段，且默认单调递增、毫秒级有序。

关键点不是“怎么生成”，而是“怎么集成进 GORM 流程”：

必须在 INSERT 前生成 ID，不能依赖数据库回填（GORM 的 db.Create() 默认会忽略已赋值的主键）
禁用 GORM 的自动主键生成：模型定义中去掉 primaryKey tag 的 auto-increment 行为，或显式设 gorm:"primaryKey;autoIncrement:false"
生成 ID 后，直接赋值给结构体字段，再调用 db.Create() —— GORM 会把该字段当普通列插入

示例：

type User struct {
    ID        uint64 `gorm:"primaryKey;autoIncrement:false"`
    Name      string
    CreatedAt time.Time
}

func CreateUser(name string) error {
    sf := sonyflake.NewSonyflake(sonyflake.Settings{})
    id, err := sf.NextID()
    if err != nil {
        return err // 注意捕获时钟回拨 panic，需降级处理
    }

    user := User{ID: id, Name: name}
    return db.Create(&user).Error
}