前言

很多.NET 项目使用 Hangfire 做后台任务、定时任务，存储选择 Redis 时，都会选用Hangfire.Redis.StackExchange。 但很少有人留意：这个开源仓库已经永久归档，原作者不再修复 Bug、不接收 PR、不处理 IssueGitHub。

我们线上业务踩了一系列坑：

1. Redis 瞬时网络抖动、主从切换，直接造成 Worker 进程崩溃，任务停止调度
2. 任务长期卡在Fetched状态，不会执行也不会重试，只能人工干预
3. Worker 进程宕机重启后，任务出现重复执行
4. Redis 脏 key、hash 格式异常直接把后台进程打挂
5. 多实例集群部署 Pub‑Sub 全局广播惊群效应，Redis 压力高

官方商业版Hangfire.Pro.Redis是收费组件，很多中小企业无法采购。 于是基于原版 LGPL‑3.0 协议，做了增强 Fork 项目：Hangfire.Redis.StackExchange.Enhanced，完全兼容原版 API，命名空间不变，平滑迁移。

问 题场景	原版 Hangfire.Redis.StackExchange	Enhanced 增强版
Redis 网络抖动	直接进程崩溃，调度停滞	异常隔离，单组件故障不整体宕机，自动恢复
脏 Key / 异常 Hash	直接抛出异常导致 Worker 挂掉	降级容错，跳过损坏数据，保障服务继续运行
Pub‑Sub 消息通知	全局广播，多实例惊群	按队列定向唤醒，保留轮询兜底，支持滚动升级
超时宕机任务	自动放回队列，极易重复执行	新增SkipRequeueOnTimeout，可选择直接标记失败
多实例抢任务	同一时刻大量 Worker 抢同一个任务	任务拉取随机抖动，均衡集群压力
分布式锁	锁超时、误释放、抢占冲突	重构锁续期、抢占、释放逻辑，边界加固
维护状态	归档停更，无任何更新	社区持续维护，生产压测验证

二、快速迁移使用

1. 替换 NuGet 包

卸载旧包，安装增强包

dotnet remove package Hangfire.Redis.StackExchange
dotnet add package Fork.Hangfire.Redis.StackExchange.Enhanced

✅命名空间完全不变：using Hangfire.Redis.StackExchange;，业务代码一行不用改。

2. 最简配置

builder.Services.AddHangfire(configuration => configuration
    .UseRedisStorage("redis://localhost:6379"));

3. 生产推荐完整配置（开启增强特性）

builder.Services.AddHangfire(configuration => configuration
    .UseRedisStorage("redis://localhost:6379", new RedisStorageOptions
    {
        Prefix = "MyApp:",
        Db = 11,
        UseTransactions = true,
        InvisibilityTimeout = TimeSpan.FromMinutes(30),
        FetchTimeout = TimeSpan.FromMinutes(3),
        SkipRequeueOnTimeout = false,    // 超时任务是否不再重新入队
        EnableFetchJitter = true,        // 开启集群抢任务抖动
        FetchJitterMaxMs = 300
    }));

builder.Services.AddHangfireServer(options =>
{
    options.Queues = new[] { "default" };
    options.WorkerCount = 2;
    options.HeartbeatInterval = TimeSpan.FromSeconds(10);
    options.ServerTimeout = TimeSpan.FromSeconds(30);
});

启用 Dashboard 面板

var app = builder.Build();
app.UseHangfireDashboard();
app.MapHangfireDashboard("/hangfire");
app.Run();

访问：http://localhost:端口/hangfire

三、核心增强特性说明

1. 网络容错隔离 Redis 断连、抖动不会直接让整个 Hangfire 后台崩溃，各个后台组件异常互相隔离，网络恢复自动恢复调度。
2. 脏 Key 容错保护 Redis 内部 key 被误操作、hash 字段损坏，不会直接造成 Worker 宕机，做降级跳过，保证其余任务正常跑。
3. 定向 Pub‑Sub 队列唤醒 不再全部实例接收全部队列消息，按队列定向推送，降低 Redis 压力；底层保留轮询兜底，消息丢失也不影响业务，支持集群滚动升级。
4. SkipRequeueOnTimeout超时策略 原版任务超时、进程宕机后，任务会无条件重新放回队列，极易重复执行。开启该配置后，超时任务直接标记失败，业务自己做重试。
5. 分布式锁与 Lua 脚本加固 修复原生锁超时误释放、事务冲突，完善 List 操作原子性，提升集群场景数据一致性。

四、已知边界（透明说明）

1. 进程被系统暴力 kill‑9 极端场景，存在极低概率孤儿任务，需要人工清理；正常异常重启不会触发。
2. Pub‑Sub 仅做性能优化，底层常驻轮询兜底，调度可靠性不受消息投递影响。

五、升级注意

• 包名变更，命名空间完全兼容，业务代码无需修改
• 新增配置项全部默认对齐原版行为，灰度升级无业务侵入
• Pub‑Sub 消息格式兼容旧版本，支持多实例滚动升级

总结

Hangfire.Redis.StackExchange已经归档停更，生产环境继续使用风险越来越高。 Enhanced 版本继承 LGPL‑3.0 开源协议，免费商用，修复大量生产坑，24 小时高并发压测验证，原有项目可以无痛迁移。

项目地址：【https://gitee.com/992582781/Hangfire.RedisStackExchange.ForkEnhanced】