如何在Java中生成基于时间与网卡的Variant 2 UUID？

问题背景 #

Java自带的java.util.UUID类虽遵循RFC 4122的Variant 2标准，但仅提供randomUUID()（Version 4，随机UUID）和nameUUIDFromBytes()（Version 3，名称UUID）两种生成方式，没有直接支持Version 1 UUID的API。而FreeBSD、Cygwin的uuidgen工具默认生成的就是Version 1 UUID——这类UUID基于时间戳和网卡MAC地址生成，碰撞概率远低于纯随机的Version 4，适合高唯一性要求的场景。

实现思路 #

按照RFC 4122规范，Version 1 UUID由三部分构成：

• 60位时间戳：以1582年10月15日（格里高利历切换日）为起点的100纳秒间隔计数
• 14位时钟序列：处理系统时钟回退导致的冲突
• 48位节点ID：优先使用网卡MAC地址，无网卡时生成随机数并标记为本地生成

同时需设置版本位（高4位为0001）和变体位（高2位为10），确保符合RFC 4122标准。

可移植实现代码 #

以下是无第三方依赖的纯Java实现，兼容主流JDK版本：

import java.net.NetworkInterface;
import java.security.SecureRandom;
import java.util.Enumeration;
import java.util.Random;
import java.util.UUID;

public class UUIDv1Generator {
    private static final long START_EPOCH = -122192928000000000L; // 1582-10-15 00:00:00 UTC
    private static final Random RANDOM = new SecureRandom();

    private static long lastTimestamp = -1L;
    private static short clockSequence = (short) RANDOM.nextInt(1 << 14);

    private static byte[] nodeId;

    static {
        nodeId = getNodeId();
    }

    public static UUID generate() {
        long timestamp = getCurrentTimestamp();
        short seq = getClockSequence(timestamp);

        // 组装UUID高64位：时间戳高32位 + 时间戳中16位 + 版本位(0001) + 时间戳低16位
        long mostSigBits = (timestamp << 32) | ((timestamp >> 16) & 0xFFFF);
        mostSigBits = (mostSigBits & 0xFFFFFFFFFFFF0FFF) | 0x0000000000001000; // 标记版本为1

        // 组装UUID低64位：变体位(10) + 时钟序列 + 节点ID
        long leastSigBits = (((long) seq) << 48) | bytesToLong(nodeId);
        leastSigBits = (leastSigBits & 0x3FFFFFFFFFFFFFFF) | 0x8000000000000000L; // 标记变体为2

        return new UUID(mostSigBits, leastSigBits);
    }

    private static long getCurrentTimestamp() {
        return System.currentTimeMillis() * 10000 + START_EPOCH;
    }

    private static synchronized short getClockSequence(long timestamp) {
        if (timestamp > lastTimestamp) {
            lastTimestamp = timestamp;
        } else {
            clockSequence = (short) ((clockSequence + 1) & 0x3FFF);
        }
        return clockSequence;
    }

    private static byte[] getNodeId() {
        try {
            Enumeration<NetworkInterface> interfaces = NetworkInterface.getNetworkInterfaces();
            while (interfaces.hasMoreElements()) {
                NetworkInterface ni = interfaces.nextElement();
                if (!ni.isLoopback() && ni.getHardwareAddress() != null) {
                    byte[] mac = ni.getHardwareAddress();
                    if (mac.length == 6) {
                        return mac;
                    }
                }
            }
        } catch (Exception e) {
            // 忽略网卡获取异常，使用随机节点ID
        }

        // 无有效网卡时生成随机48位节点ID，最高位设为1标记为本地生成
        byte[] randomNode = new byte[6];
        RANDOM.nextBytes(randomNode);
        randomNode[0] |= (byte) 0x01;
        return randomNode;
    }

    private static long bytesToLong(byte[] bytes) {
        long result = 0;
        for (byte b : bytes) {
            result = (result << 8) | (b & 0xFF);
        }
        return result;
    }
}

使用示例 #

UUID v1Uuid = UUIDv1Generator.generate();
System.out.println("Version 1 UUID: " + v1Uuid);
System.out.println("Version: " + v1Uuid.version()); // 输出1
System.out.println("Variant: " + v1Uuid.variant()); // 输出2（对应RFC4122）

注意事项 #

1. 时钟回退处理：系统时间回退时自动递增时钟序列，避免UUID重复
2. 节点ID兼容性：优先取非回环网卡MAC地址，无网卡时生成随机节点ID并标记为本地生成
3. 线程安全：时钟序列更新使用synchronized保证多线程环境下的唯一性

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