Go sonyflake 怎样配置机器编号生成分布式整数ID

在多个 Go 实例同时生成整数 ID 时，机器编号不是随便填一个数字就结束了：同一时间窗口内，只要两个实例拿到相同的 machineID，就可能破坏全局唯一性。更稳妥的做法是使用 github.com/sony/sonyflake/v2，由部署系统分配稳定编号，再通过 Settings.MachineID 返回它。

官方地址：https://pkg.go.dev/github.com/sony/sonyflake/v2

先明确 sonyflake 的机器编号职责

sonyflake/v2 默认把一个 ID 拆成 39 位时间、8 位序列号和 16 位机器编号，时间单位默认是 10 毫秒。机器编号只负责区分生成者，不是自增主键，也不应把容器临时 IP 当作长期身份。默认回调会取私有 IP 的低 16 位，容器重建、网卡变化或多网卡环境都可能让这个值难以审计，因此生产服务最好显式配置。

用 Settings 固定每个实例的 machineID

最小配置可以让环境变量或部署清单提供一个整数编号。下面的示例使用固定值 23 代表某个实例，重点是把编号来源和范围检查集中在 Settings 中；真实集群还应把“编号是否已被占用”放进共享登记表、租约服务或发布平台。

package main

import (
    "fmt"
    "time"

    sonyflake "github.com/sony/sonyflake/v2"
)

func main() {
    machineID := 23 // 该值应来自部署清单或带租约的编号登记表
    st := sonyflake.Settings{
        BitsSequence:  8,
        BitsMachineID: 16,
        TimeUnit:      10 * time.Millisecond,
        MachineID: func() (int, error) {
            // 显式返回本实例编号，避免依赖临时网络地址。
            return machineID, nil
        },
        CheckMachineID: func(id int) bool {
            // 这里只检查范围；生产环境还要查询共享登记状态。
            return id >= 0 && id 

注意 CheckMachineID 返回 true 只代表检查通过，库本身不会替你在多台机器之间加锁。若编号来自数据库，应在分配和续租时处理并发；若实例退出，编号也不要立刻复用，至少要等旧实例的租约失效。

位数配置决定容量与生命周期

BitsMachineID 越大，可区分的实例越多；BitsSequence 越大，单个实例在同一时间单位内可容纳的 ID 越多，但两者会共同挤占时间字段。库要求两者都不超过 30，二者之和不能达到 32，否则剩余时间位不足。默认 16/8 的组合意味着机器编号范围是 0 到 65535、序列号范围是 0 到 255；如果把机器位加到 20，就要重新评估时间跨度和迁移兼容性。

TimeUnit 不能小于 1 毫秒，默认 10 毫秒。吞吐压力大时，不要只改位数：可以先按实例峰值 QPS 选择序列位，再按实际集群规模确定机器位，最后确认时间位足以覆盖约定的 StartTime 到生命周期终点。

扩容和滚动发布的编号清单

• 编号以“逻辑实例”登记，而不是以短暂容器 ID 登记。
• 新实例先申请未占用编号，创建 Sonyflake 成功后再接收流量。
• 滚动发布期间不要让新旧实例共享同一编号，旧租约失效后再回收。
• 改动位布局或时间单位时，先确认下游按 int64 存储且不会把新旧 ID 当成同一编码解释。

常见问题

只设置 MachineID 不设置 BitsMachineID 可以吗？

可以，0 会使用默认的 16 位机器编号；但显式写出位数更容易让部署配置、容量评估和代码审查保持一致。

CheckMachineID 能自动发现另一台机器的重复编号吗？

不能。它只是创建实例时被调用的校验函数，重复检测的数据源需要由应用接入数据库、注册中心或租约系统维护。

归纳起来，sonyflake 的关键不是“给每台机器随便编号”，而是把编号分配、唯一性检查和位布局当成同一份部署契约：先固定身份，再创建实例，最后按容量边界检查 NextID 的使用方式。