IHostedService未执行StartAsync的根本原因是注册方式错误：必须用AddHostedService<T>()，而非AddSingleton<T>()或AddScoped<T>()；宿主仅识别前者并自动调用其生命周期方法。
为什么 IHostedService 启动后没执行 StartAsync
常见现象是注册了服务但日志里完全看不到 StartAsync 被调用，任务也没跑起来。根本原因不是代码写错了，而是注册方式不对：必须用 AddHostedService<T>()，不能用 AddSingleton<T>() 或 AddScoped<T>()。
ASP.NET Core 的宿主系统只识别通过 AddHostedService 注册的类型，并在应用启动完成时统一调用其 StartAsync。其他注册方式只是把类当普通服务注入，宿主完全不感知。
-
AddHostedService<MyBackgroundService>()✅ 正确入口 -
AddSingleton<MyBackgroundService>()❌ 不触发生命周期方法 - 确保注册发生在
Program.cs的builder.Services阶段，不能放到中间件或控制器里
IHostedService 中怎么安全地处理长时间运行的任务
直接在 StartAsync 里写 while (true) + Thread.Sleep 是危险的：会阻塞主线程、无法响应取消信号、重启时可能卡死。
正确做法是基于 CancellationToken + Task.Delay 实现可中断的循环，且所有异步操作都显式接受该 token。
- 始终把传入的
cancellationToken传给Task.Delay、HttpClient.GetAsync等异步方法 - 避免使用
Thread.Sleep、Task.Run(() => { Thread.Sleep(...) })这类同步阻塞 - 在
StopAsync中不要“强行等完”，而是协作式退出：检查cancellationToken.IsCancellationRequested并尽快返回
public class PollingService : IHostedService
{
private Timer? _timer;
public Task StartAsync(CancellationToken cancellationToken)
{
_timer = new Timer(DoWork, null, TimeSpan.Zero, TimeSpan.FromMinutes(5));
return Task.CompletedTask;
}
private async void DoWork(object? state)
{
// 注意：Timer 回调不带 CancellationToken，需自行捕获并传递
await DoActualWorkAsync(CancellationToken.None); // 更推荐用 PeriodicTimer 或手动调度
}
}
多个 IHostedService 的启动顺序怎么控制
默认没有顺序保证 —— 所有 IHostedService 的 StartAsync 由宿主并发调用，谁快谁先执行。如果你的服务 A 依赖服务 B 初始化完毕（比如 B 建连数据库，A 才开始查），就得手动干预。
最轻量的办法是让 A 在 StartAsync 里主动等待 B 的就绪信号，而不是靠注册顺序。
- 用
TaskCompletionSource<bool>在 B 的StartAsync结束时SetResult(true) - A 的
StartAsync开头 await 这个Task，超时时间建议设为 30 秒，避免启动卡死 - 不要依赖
IServiceCollection的添加顺序 —— 它不保证执行顺序，.NET 6+ 甚至会重排
部署到 Linux 容器后 IHostedService 意外退出
典型表现是容器日志显示应用“正常退出”，但后台任务中途断掉。问题往往出在 StopAsync 超时或未正确处理 SIGTERM。
Linux 容器收到停止信号后，默认只给 ASP.NET Core 5 秒（Kubernetes 可能更短）执行 StopAsync。如果任务没及时结束，进程会被强制 kill，StopAsync 中的清理逻辑（如发告警、刷缓存）全丢弃。
- 在
StopAsync中别做耗时 IO；如必须，用cancellationToken+ 超时控制，例如await task.WaitAsync(TimeSpan.FromSeconds(2)) - 检查容器运行命令是否加了
--init（如docker run --init），否则 SIGTERM 可能无法传给 .NET 进程 - 确认
DOTNET_SHUTDOWN_TIMEOUT环境变量没被设成过小值（默认 5 秒）
CancellationToken、绕过 StopAsync、或假设执行顺序的行为，上线后都会在某个凌晨三点准时报错。 
