0

0

C#如何实现雪花算法 Snowflake ID生成器C#实现

星降

星降

发布时间:2026-01-14 09:06:09

|

960人浏览过

|

来源于php中文网

原创

c#雪花算法生成64位唯一id,结构为1位符号位+41位时间戳+10位机器id+12位序列号;需用interlocked保证线程安全,处理时钟回拨,并确保workerid全局唯一且在0~1023范围内。

c#如何实现雪花算法 snowflake id生成器c#实现

在C#中实现雪花算法(Snowflake ID),核心是按位组装一个64位长整型(long),结构为:1位符号位(固定为0)+ 41位时间戳(毫秒级,起始时间自定义)+ 10位机器ID(支持最多1024个节点)+ 12位序列号(每毫秒内可生成4096个ID)。关键在于线程安全、时钟回拨处理和ID唯一性保障。

基础结构与位运算设计

64位ID按如下方式划分(从高位到低位):

  • 0:1位,保留位,始终为0(保证long为正数)
  • timestamp:41位,毫秒时间戳(建议使用自定义纪元,如2020-01-01T00:00:00.000Z,避免溢出)
  • datacenterId:5位(可选)+ workerId:5位 → 合计10位,共1024种组合
  • sequence:12位,本毫秒内递增序号(0~4095),超限时等待至下一毫秒

推荐将 datacenterId 和 workerId 合并为一个 workerId(0~1023),简化部署。位移偏移量通常设为:timestampLeftShift = 22workerIdLeftShift = 12sequenceMask = 0xFFF(即4095)。

线程安全的ID生成器实现

使用 System.Threading.Interlocked 保证 sequence 和 lastTimestamp 的原子操作,避免锁开销:

  • private long _sequence = 0private long _lastTimestamp = -1 作为实例字段
  • 每次生成前调用 Interlocked.CompareExchange(ref _lastTimestamp, timestamp, old) 判断是否跨毫秒
  • 同毫秒内通过 Interlocked.Increment(ref _sequence) & sequenceMask 获取新序号
  • 若 sequence 溢出(等于0),主动等待至下一毫秒再重试

注意:不要用 lockMonitor,高并发下会成为瓶颈;静态类 + 单例模式更合适,确保每个服务实例有唯一 workerId。

如此AI写作
如此AI写作

AI驱动的内容营销平台,提供一站式的AI智能写作、管理和分发数字化工具。

下载

时钟回拨容错处理

服务器时间向后调整(NTP校准)可能导致重复ID或阻塞。常见策略有:

  • 容忍小范围回拨(如 ≤ 5ms):缓存最近一次合法时间戳,允许短暂回退并复用 sequence
  • 拒绝生成:发现回拨直接抛异常(适合强一致性场景)
  • 等待恢复:循环检测系统时间直到 ≥ 上次时间戳(慎用,可能卡死)

生产环境建议采用第一种:记录 _lastValidTimestamp,当 current 时抛异常;当 <code>current 但差值≤5ms时,继续用原 timestamp + 递增 sequence。

WorkerId 分配与配置建议

workerId 必须全局唯一,不能靠随机或进程PID(易冲突)。推荐方式:

  • 启动时从配置文件环境变量读取(如 WORKER_ID=12
  • 结合 Consul/Etcd 实现自动注册与分配(避免人工干预)
  • K8s 场景下可用 Pod IP 的哈希后取模(ip.GetHashCode() % 1024),需加防止单点哈希碰撞的兜底逻辑

务必校验 workerId ∈ [0, 1023],越界应启动失败并报错,不静默截断。

基本上就这些。只要注意位运算无误、sequence 原子更新、时间判断严谨、workerId 可控,一个轻量健壮的 Snowflake ID 生成器就完成了。不需要第三方库,.NET Core 3.1+ 原生支持完全足够。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

723

2023.08.10

页面置换算法
页面置换算法

页面置换算法是操作系统中用来决定在内存中哪些页面应该被换出以便为新的页面提供空间的算法。本专题为大家提供页面置换算法的相关文章,大家可以免费体验。

483

2023.08.14

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

28

2026.02.28

Golang 工程化架构设计:可维护与可演进系统构建
Golang 工程化架构设计:可维护与可演进系统构建

Go语言工程化架构设计专注于构建高可维护性、可演进的企业级系统。本专题深入探讨Go项目的目录结构设计、模块划分、依赖管理等核心架构原则,涵盖微服务架构、领域驱动设计(DDD)在Go中的实践应用。通过实战案例解析接口抽象、错误处理、配置管理、日志监控等关键工程化技术,帮助开发者掌握构建稳定、可扩展Go应用的最佳实践方法。

23

2026.02.28

Golang 性能分析与运行时机制:构建高性能程序
Golang 性能分析与运行时机制:构建高性能程序

Go语言以其高效的并发模型和优异的性能表现广泛应用于高并发、高性能场景。其运行时机制包括 Goroutine 调度、内存管理、垃圾回收等方面,深入理解这些机制有助于编写更高效稳定的程序。本专题将系统讲解 Golang 的性能分析工具使用、常见性能瓶颈定位及优化策略,并结合实际案例剖析 Go 程序的运行时行为,帮助开发者掌握构建高性能应用的关键技能。

27

2026.02.28

Golang 并发编程模型与工程实践:从语言特性到系统性能
Golang 并发编程模型与工程实践:从语言特性到系统性能

本专题系统讲解 Golang 并发编程模型,从语言级特性出发,深入理解 goroutine、channel 与调度机制。结合工程实践,分析并发设计模式、性能瓶颈与资源控制策略,帮助将并发能力有效转化为稳定、可扩展的系统性能优势。

16

2026.02.27

Golang 高级特性与最佳实践:提升代码艺术
Golang 高级特性与最佳实践:提升代码艺术

本专题深入剖析 Golang 的高级特性与工程级最佳实践,涵盖并发模型、内存管理、接口设计与错误处理策略。通过真实场景与代码对比,引导从“可运行”走向“高质量”,帮助构建高性能、可扩展、易维护的优雅 Go 代码体系。

18

2026.02.27

Golang 测试与调试专题:确保代码可靠性
Golang 测试与调试专题:确保代码可靠性

本专题聚焦 Golang 的测试与调试体系,系统讲解单元测试、表驱动测试、基准测试与覆盖率分析方法,并深入剖析调试工具与常见问题定位思路。通过实践示例,引导建立可验证、可回归的工程习惯,从而持续提升代码可靠性与可维护性。

2

2026.02.27

漫蛙app官网链接入口
漫蛙app官网链接入口

漫蛙App官网提供多条稳定入口,包括 https://manwa.me、https

164

2026.02.27

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号