Hangfire任务不执行主因是AddHangfire、AddHangfireServer、UseHangfireDashboard三步缺失或顺序错误；周期任务时间不准多因Cron未配时区。
Hangfire 任务不执行，八成是 AddHangfire、AddHangfireServer、UseHangfireDashboard 这三步漏了或顺序错了；周期任务时间不准，基本是 Cron 表达式没配时区。
Program.cs 必须配齐三件套，缺一不可
Hangfire 不是装完 NuGet 就能跑的框架。它依赖三个明确的注册/启用环节，少一个，任务就卡住或 Dashboard 打不开。
-
AddHangfire负责注册存储（比如UseSqlServerStorage），不配 → 任务不持久，应用重启后全丢；传错连接字符串或数据库连不上，启动时直接抛异常 -
AddHangfireServer必须紧跟其后，它才是真正干活的工作线程；没这句 → 所有任务状态永远停在Scheduled或Enqueued，永远不会执行 -
UseHangfireDashboard必须放在app.UseEndpoints之前；放错位置 → 访问/hangfire直接返回 404 - 常见报错
No service for type 'Hangfire.IBackgroundJobClient'，基本就是AddHangfire没调用，或被其他代码覆盖了服务注册顺序
延迟任务必须用 BackgroundJob.Schedule，别混用 Task.Delay
BackgroundJob.Enqueue 是立即入队、尽快执行；BackgroundJob.Schedule 才是带延迟的，两者底层队列和参数语义完全不同。
- 正确写法：
BackgroundJob.Schedule(() => emailService.Send("user@ex.com"), TimeSpan.FromMinutes(3)) - 错误写法：
Task.Delay(TimeSpan.FromMinutes(3)).ContinueWith(_ => BackgroundJob.Enqueue(...))—— 这只是主线程空等，既阻塞又不可靠，且失败无法重试 - 注意时间精度：Hangfire 默认轮询间隔是 15 秒，所以“精确到秒级延时”不现实；毫秒级（如
TimeSpan.FromMilliseconds(500)）会被截断，别传 - 闭包陷阱：避免在 lambda 里捕获循环变量，比如
for (int i = 0; i < 10; i++) BackgroundJob.Schedule(() => Console.WriteLine(i), ...)，最后可能全输出 10
RecurringJob.AddOrUpdate 必须显式指定 TimeZoneInfo
Hangfire 默认按服务器本地时区解析 Cron，不是 UTC。开发机上写 "0 0 * * *"（每天 0 点），部署到 UTC 时区的 Docker 容器里，实际就是北京时间早上 8 点执行。
- 推荐做法：
RecurringJob.AddOrUpdate("daily-cleanup", () => Cleanup(), "0 0 * * *", TimeZoneInfo.FindSystemTimeZoneById("China Standard Time")) - 备选方案：统一容器时区，在
Dockerfile加ENV TZ=Asia/Shanghai && ln -snf /usr/share/zoneinfo/$TZ /etc/localtime - Cron 格式是「分 时 日 月 周」，不带秒；写
"*/30 * * * * *"会静默失败，得换Hangfire.Cronos扩展包 - 并发风险：同一周期任务若执行时间长于调度间隔，可能并发跑多个实例；加
[DisableConcurrentExecution]特性或分布式锁防重入
Dashboard 生产环境必须实现 IDashboardAuthorizationFilter
默认的 LocalRequestsOnlyAuthorizationFilter 只允许 localhost 访问，但生产环境常走反向代理（Nginx、Kestrel 前置），Request.IsLocal 会失效，导致 Dashboard 403。
- 不要删授权配置，也不要设
Authorization = null；应自定义实现IDashboardAuthorizationFilter，校验请求头（如X-Forwarded-For）、Token 或 IP 白名单 - 仪表盘暴露的是完整作业上下文，含参数、异常堆栈、甚至数据库连接字符串（若日志打印不当），未授权访问风险极高
- 即使内网部署，也建议强制 Basic Auth 或对接公司统一认证，别图省事绕过
