讲师中心 微信公众号
AI工具推荐 视频效率加速

C#怎么实现分布式ID生成 C#如何用Snowflake和ULID生成全局唯一有序的分布式ID【算法】

落敏姑娘_6937

落敏姑娘_6937

发布时间:2026-04-15 13:26:25

|

782人浏览过

|

来源于php中文网

原创

Snowflake ID 不保证全局严格递增,仅单机内趋势递增,因时间回拨、workerId冲突或sequence重置导致MySQL中ORDER BY id DESC漏数据,需配合created_at字段及联合索引使用。

c#怎么实现分布式id生成 c#如何用snowflake和ulid生成全局唯一有序的分布式id【算法】

为什么直接用 SnowflakeId 生成的 ID 在 MySQL 中可能“不严格递增”

很多人以为 Snowflake ID 天然适合 MySQL 的自增主键替代方案,结果上线后发现 ORDER BY id DESC 查最新数据时漏掉几条——不是数据库问题,是时间回拨 + 机器 ID 分配混乱导致序列局部乱序。Snowflake 本身只保证「单机内趋势递增」,不保证全局严格单调。尤其在容器动态调度、K8s Pod 重启、NTP 校时等场景下,timestamp 回退或 sequence 重置会直接破坏顺序性。

实操建议:

  • 避免把 SnowflakeId 当作 MySQL 的 AUTO_INCREMENT 等价物;如需按时间倒序查,必须加 created_at 字段并建联合索引((created_at, id))
  • 用 workerId 时别硬编码,推荐从配置中心或 Consul 获取,防止多实例部署时重复
  • 若用 Microsoft.Extensions.DependencyInjection 注册生成器,记得设为 Singleton,否则每次 new 都会重置 sequence

ULID 在 C# 中怎么落地:别只装 ULID NuGet 包就完事

ULID(Universally Unique Lexicographically Sortable Identifier)比 UUID 更适合做数据库主键,但 .NET 官方没原生支持,社区包质量参差不齐。最常用的是 RobThree/ULID,但它默认生成的是 128-bit 二进制格式(byte[]),直接转字符串是 Base32 编码,长度 26 位——而很多老系统字段只预留了 32 位 VARCHAR,这没问题;但如果你把它当 Guid 用(比如 EF Core 映射成 Guid 类型),运行时直接抛 InvalidCastException。

实操建议:

  • 生成后立刻调用 .ToString() 得到可存储的字符串,不要试图塞进 Guid 或 long
  • EF Core 中对应字段类型必须是 string,且显式指定列类型:modelBuilder.Entity<t>().Property(e => e.Id).HasColumnType("varchar(26)")</t>
  • 如果需要兼容旧版 SQL Server(datetime 精度只有 3.33ms),注意 ULID 时间戳精度是毫秒级,不会出错;但若业务依赖「同一毫秒内生成多个 ID 的字典序」,得确认数据库排序规则是否区分大小写(ULID 使用 Base32,含数字和大写字母)

什么时候该选 Snowflake,什么时候该切 ULID

没有银弹。Snowflake ID 是 64 位整数,天然支持 long 运算、索引紧凑、MySQL 查询快;ULID 是字符串,占空间大、索引体积高,但完全去中心化、无需配置 workerId、无时间回拨风险、字符串本身可直接排序。

选型依据:

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 用 MySQL / PostgreSQL 且对写入吞吐要求极高(>5w QPS),优先 Snowflake;但得配套运维时间同步、workerId 分配机制
  • 微服务跨语言(Go/Python/Java 都要生成 ID),选 ULID——各语言实现行为一致,不用协调中心节点
  • 日志、事件溯源类场景,ID 要求人类可读、可大致判断时间(如 01HJ2XQZ7Z... 开头能看出是 2024 年),ULID 更友好
  • 已有系统用 Guid.NewGuid(),想平滑过渡到有序 ID,ULID 字符串长度接近(32 → 26),字段变更成本最低

C# 实现一个最小可用的 Snowflake 生成器要注意什么

网上抄来的 SnowflakeId 类常忽略线程安全和边界校验,上线后某天凌晨突然生成重复 ID。核心是 sequence 计数器必须原子递增,且每毫秒用完后要阻塞等待下一毫秒,不能溢出还硬加。

关键代码逻辑(非完整类,仅标重点):

private long _lastTimestamp = -1L;
private long _sequence = 0L;
private readonly long _workerId;
private const long Twepoch = 1288834974657L; // 基准时间
private const int SequenceBits = 12;
private readonly long _maxSequence = ~(-1L << SequenceBits); // 4095
<p>public long NextId()
{
var timestamp = CurrentTimeMillis();
if (timestamp < _lastTimestamp) throw new Exception($"Clock moved backwards: {_lastTimestamp} > {timestamp}");</p><pre class="brush:php;toolbar:false;">if (_lastTimestamp == timestamp)
{
    _sequence = (_sequence + 1) & _maxSequence;
    if (_sequence == 0) timestamp = TilNextMillis(_lastTimestamp); // 阻塞
}
else
{
    _sequence = 0L;
}

_lastTimestamp = timestamp;
return ((timestamp - Twepoch) << TimestampLeftShift) |
       (_workerId << WorkerIdLeftShift) |
       _sequence;

}

容易被忽略的点:

  • TilNextMillis 必须用 while (CurrentTimeMillis() ,不能用 <code>Thread.Sleep,否则可能睡过头
  • _workerId 和 _datacenterId 如果合用一个字段(常见简化版),总位宽不能超 10 位,否则会挤占 sequence 空间
  • 测试时别用 DateTime.Now 模拟时间,要用 Stopwatch 或注入时间提供器,否则单元测试跑不稳

C# 做分布式 ID,最难的从来不是算法本身,而是把时间、机器标识、序列三者在真实部署环境里对齐。本地跑通 100 万次不重复,不等于 K8s 里三个副本同时扩容时不撞车。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

1032

2023.08.08

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2951

2023.08.31

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

885

2024.03.13

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2615

2024.03.14

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

312

2026.02.03

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

389

2026.02.06

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

631

2026.03.11

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

329

2026.04.13

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn