Hutool实现UUID和雪花算法ID

原创已于 2026-03-31 12:04:42 修改 · 4.7k 阅读 ·

大模型引用 1 次

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

代码可运行

于 2023-10-16 16:00:21 首次发布

博客介绍了Java中生成唯一ID的相关内容，包括引用Maven依赖，还提及了生成UUID以及通过雪花算法生成唯一ID的方法，这些都是信息技术领域在Java开发中常用的操作。

1、引用Maven依赖

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.16</version>
</dependency>

2、生成UUID

//生成的UUID是带-的字符串，类似于：a5c8a5e8-df2b-4706-bea4-08d0939410e3
String uuid = IdUtil.randomUUID();

//生成的是不带-的字符串，类似于：b17f24ff026d40949c85a24f4f375d42
String simpleUUID = IdUtil.simpleUUID();

3、雪花算法ID业务类型

/**
 * 雪花算法业务类型
 *
 * @author Lucas
 * date 2026/3/31 10:33
 */
public enum SnowflakeType {
    /**
     * 评论ID
     */
    Comment
}

4、通过雪花算法生成唯一ID

import cn.hutool.core.lang.Snowflake;
import cn.hutool.core.net.NetUtil;
import cn.hutool.core.util.StrUtil;

import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;

/**
 * 多业务隔离雪花算法工具类
 *
 * @author Lucas
 * date 2025/8/15 09:40
 */
public class BizSnowflakeUtil {
    // 终端ID
    private static final Long WORKER_ID = resolveWorkerId();
    // 数据中心ID
    private static final Long DATA_CENTER_ID = resolveDataCenterId();
    // 业务隔离
    private static final Map<SnowflakeType, Snowflake> CACHE = new ConcurrentHashMap<>();

    // 初始化所有类型
    static {
        for (SnowflakeType type : SnowflakeType.values()) {
            CACHE.put(type, createSnowflake());
        }
    }

    /**
     * 创建 Snowflake 实例（Snowflake 本身线程安全）
     * 说明：每个业务独立实例，保证业务内部 ID 不重复
     */
    private static Snowflake createSnowflake() {
        // isUseSystemClock：禁用异步时钟、timeOffset：回拨容忍毫秒、randomSequenceLimit：随机 sequence 起点
        return new Snowflake(null, WORKER_ID, DATA_CENTER_ID, false, 500L, 32L);
    }

    /**
     * 获取雪花ID
     */
    public static Long getSnowflake(SnowflakeType type) {
        return CACHE.computeIfAbsent(type, key -> createSnowflake()).nextId();
    }

    /**
     * 根据 Pod Name(HOSTNAME) 生成 WorkerId（保证同 Node 下 Pod 不同）
     */
    private static Long resolveWorkerId() {
        // 获取HOSTNAME计算
        String podName = System.getenv("HOSTNAME");
        if (StrUtil.isNotBlank(podName)) {
            return (long) Math.floorMod(podName.hashCode(), 32);
        }
        // 使用 IP 地址计算（不推荐但保底）
        String ip = NetUtil.getLocalhostStr();
        int index = ip.lastIndexOf('.');
        return Long.parseLong(ip.substring(index + 1)) & 31;
    }

    /**
     * 根据 Node IP 生成 DataCenterId（保证同一物理机一样）
     */
    private static Long resolveDataCenterId() {
        String ip = NetUtil.getLocalhostStr();
        return (long) (ip.hashCode() & 0x1F);
    }
}

标签

#java

分类后端开发