.NET Core 7中BackgroundService实现的Windows Service关机未触发StopAsync

针对你遇到的问题——手动停止服务时StopAsync里的日志正常输出，但关机重启后无日志，以下是几个核心排查点和解决办法：

• 关机超时限制导致操作未完成
  Windows关机时给服务预留的停止时间默认较短（通常20秒内），如果日志写入、文件操作等任务没来得及完成，或者CancellationToken提前触发，都会导致操作中断。你可以尝试延长服务的关机超时时间，在Program.cs中配置：

services.Configure<HostOptions>(options =>
{
    options.ShutdownTimeout = TimeSpan.FromSeconds(30); // 调整为合适的时长
});

同时在StopAsync中确保操作能快速完成，并且处理取消信号。

• 事件日志服务提前终止
  关机时系统的事件日志服务可能早于你的服务停止，这时候即使代码执行了LogWarning，日志也无法被写入系统日志。建议换用本地文件验证StopAsync是否真的执行：

public override Task StopAsync(CancellationToken cancellationToken)
{
    // 写入本地文件替代事件日志验证
    File.AppendAllText(@"C:\temp\service_shutdown.log", $"服务停止于: {DateTime.Now}{Environment.NewLine}");
    logger.LogWarning("Test Service is Stopping...");
    return base.StopAsync(cancellationToken);
}

重启后检查该文件是否有内容，就能判断StopAsync是否执行。

• 服务未正确配置关机响应
  确保你的服务启用了关机响应能力。对于.NET的BackgroundService，需要确保宿主正确处理关机事件，同时服务账户有足够权限。另外，检查服务的启动类型为Automatic，并且在服务属性的“登录”选项中使用具备足够权限的账户（比如LocalSystem）。

• ExecuteAsync未正确响应取消信号
  如果你的ExecuteAsync方法没有定期检查CancellationToken，会导致服务无法快速停止，进而影响StopAsync的执行。要在ExecuteAsync中确保响应取消：

protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
    while (!stoppingToken.IsCancellationRequested)
    {
        // 你的文件夹监控逻辑
        await Task.Delay(1000, stoppingToken); // 延迟时传入取消令牌
    }
}

这样服务收到停止信号时，ExecuteAsync能快速退出，让StopAsync正常执行。

内容的提问来源于stack exchange，提问作者gkapellmann