惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

人人都是产品经理
人人都是产品经理
博客园_首页
博客园 - 三生石上(FineUI控件)
V
Visual Studio Blog
Hugging Face - Blog
Hugging Face - Blog
美团技术团队
小众软件
小众软件
T
Tailwind CSS Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
月光博客
月光博客
有赞技术团队
有赞技术团队
WordPress大学
WordPress大学
博客园 - 【当耐特】
Apple Machine Learning Research
Apple Machine Learning Research
罗磊的独立博客
V
V2EX
酷 壳 – CoolShell
酷 壳 – CoolShell
IT之家
IT之家
量子位
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
Recent Announcements
Recent Announcements
M
MIT News - Artificial intelligence
阮一峰的网络日志
阮一峰的网络日志
The GitHub Blog
The GitHub Blog

博客园 - 彪悍的代码不需要注释

AI编写的离线压测工具 虚拟机ftp安装 openclaw本地安装 Redhat服务器离线安装FTP 使用python脚本提取SVN近10年提交记录 本地VMware Workstation Pro的rhel-server-7.9-x86_64服务器配置本地源 敏感词过滤 限流 Windows本地生成SSL证书,用于本地调试 【转】大文件上传原理及C#实现方案 【转】C# 实现接口幂等性的四种方案 WPF创建不规则窗体时WebBrowser控件不显示的问题 QrCode .NET之Kill -15 优雅退出 排查java代码慢-arthas工具 针对clickonce发布后的程序,优化处理省略弹出层 赔率 winform发布ClickOnce到Linux服务器 CentOS obs直播RTMP协议推流到Nginx流媒体服务器到VUE使用HLS直播
幂等性
彪悍的代码不需要注释 · 2025-05-18 · via 博客园 - 彪悍的代码不需要注释

在分布式系统中,幂等性是一个重要的概念。它指的是一次和多次请求某一个资源应该具有同样的效果,即多次执行同样的操作,系统的状态不会发生改变。在网络不稳定或存在重试机制的情况下,保证接口的幂等性尤为重要,它可以防止因重复操作导致的数据不一致问题。

本文将介绍在C#中实现接口幂等性的四种方案,并通过示例代码进行详细说明。

方案一:使用唯一ID

为每次请求生成一个唯一ID(如GUID),在处理请求时,先检查这个ID是否已经被处理过。如果是,则直接返回之前的结果;如果不是,则进行处理并保存结果。

public class IdempotentService
{
    private static readonly ConcurrentDictionary<string, string> Cache = new ConcurrentDictionary<string, string>();

    public string ProcessRequestWithUniqueId(string requestId, string input)
    {
        // 检查请求是否已处理
        if (Cache.TryGetValue(requestId, out string result))
        {
            return result; // 返回之前处理的结果
        }

        // 模拟处理过程
        result = "Processed: " + input;
        // 保存处理结果
        Cache[requestId] = result;
        return result;
    }
}

// 使用示例
var service = new IdempotentService();
string requestId = Guid.NewGuid().ToString(); // 生成唯一ID
string input = "Hello, World!";
string result = service.ProcessRequestWithUniqueId(requestId, input);
Console.WriteLine(result); // 输出:Processed: Hello, World!
// 再次使用相同的requestId调用,将返回相同的结果
string result2 = service.ProcessRequestWithUniqueId(requestId, "Different Input");
Console.WriteLine(result2); // 输出:Processed: Hello, World!(与第一次调用相同)

View Code

方案二:利用数据库的唯一约束

通过在数据库中设置唯一约束(如唯一索引或主键),可以确保重复插入相同数据时被数据库拒绝,从而实现幂等性。

public class DatabaseIdempotentService
{
    // 假设有一个方法用于将数据插入数据库
    public bool InsertData(string data)
    {
        try
        {
            // 模拟数据库插入操作,如果数据已存在,则抛出异常
            if (DataExists(data))
            {
                throw new Exception("Data already exists");
            }
            // 模拟成功插入数据
            Console.WriteLine($"Data inserted: {data}");
            return true;
        }
        catch (Exception)
        {
            // 插入失败(可能是重复数据)
            return false;
        }
    }

    // 模拟检查数据是否存在的方法
    private bool DataExists(string data)
    {
        // 实际开发中,这里应该是查询数据库的操作
        return false; // 示例中始终返回false,表示数据不存在
    }
}

// 使用示例
var dbService = new DatabaseIdempotentService();
string data = "Some unique data";
bool result = dbService.InsertData(data); // 尝试插入数据,返回true表示成功,

View Code

方案三:分布式锁

在分布式系统中,可以使用分布式锁来确保同一时间只有一个请求能够执行某个操作。这可以通过Redis等工具的分布式锁功能来实现。

注意:这里的IRedisClientLockUnlock方法是假设的接口和方法,具体实现需要依赖你所使用的Redis客户端库。

public class DistributedLockIdempotentService
{
    private static readonly string LockKey = "my_lock_key";
    private readonly IRedisClient _redisClient; // 假设使用StackExchange.Redis等库

    public DistributedLockIdempotentService(IRedisClient redisClient)
    {
        _redisClient = redisClient;
    }

    public string ProcessRequestWithLock(string input)
    {
        // 尝试获取分布式锁
        if (_redisClient.Lock(LockKey, TimeSpan.FromSeconds(30))) // 锁定30秒
        {
            try
            {
                // 模拟处理过程,这里应该是实际的业务逻辑
                string result = "Processed with lock: " + input;
                return result;
            }
            finally
            {
                // 释放锁
                _redisClient.Unlock(LockKey);
            }
        }
        else
        {
            // 获取锁失败,可能已经有其他请求在处理,返回默认结果或错误信息
            return "Failed to acquire lock";
        }
    }
}

View Code

方案四:状态机幂等

在设计业务逻辑时,可以通过状态机的方式来保证幂等性。即,每个操作都对应一个状态,只有当状态满足一定条件时,操作才能被执行。

在这个示例中,我们使用了一个简单的状态机来跟踪每个请求的处理状态。如果请求已经处理过(处于ProcessingCompleted状态),则直接返回之前的结果。否则,开始处理请求并更新状态。

public class StateMachineIdempotentService
{
    private enum ProcessingState
    {
        NotStarted,
        Processing,
        Completed
    }

    private static readonly ConcurrentDictionary<string, ProcessingState> States = new ConcurrentDictionary<string, ProcessingState>();

    public string ProcessRequestWithStateMachine(string requestId, string input)
    {
        // 检查当前状态
        var currentState = States.GetOrAdd(requestId, ProcessingState.NotStarted);
        switch (currentState)
        {
            case ProcessingState.NotStarted:
                // 更新状态为正在处理中
                States[requestId] = ProcessingState.Processing;
                // 模拟处理过程
                string result = "Processed with state machine: " + input;
                // 更新状态为已完成
                States[requestId] = ProcessingState.Completed;
                return result;
            case ProcessingState.Processing:
            case ProcessingState.Completed:
                // 如果已经在处理中或已完成,则直接返回之前的结果或错误信息
                return "Request already processed";
            default:
                throw new InvalidOperationException("Unknown state");
        }
    }
}

View Code

结论

幂等性在分布式系统中是一个重要的概念,它可以确保系统的稳定性和数据的一致性。本文介绍了四种在C#中实现接口幂等性的方案,包括使用唯一ID、利用数据库的唯一约束、分布式锁和状态机。这些方案各有优缺点,适用于不同的场景和需求。在实际开发中,应根据具体情况选择合适的方案来确保接口的幂等性。