.NET Worker服务部署为Windows服务启动30秒超时被终止如何修复？

问题根因 #

该问题本质是Worker服务启动流程被同步阻塞操作卡住，导致Host未及时向Windows服务管理器发送启动成功信号，Windows等满30秒超时后判定服务启动失败并强制终止，此时业务逻辑实际已经正常启动运行。
具体到代码层面，BackgroundService的StartAsync方法会等待ExecuteAsync的初始化阶段完成后才会发送启动成功通知，而你在ExecuteAsync开头直接执行了同步数据库查询操作，一旦数据库连接慢、查询耗时或者权限校验阻塞，就会占满30秒的启动超时窗口。

修复步骤 #

1. 调整ExecuteAsync启动逻辑 #

在ExecuteAsync最开头添加await Task.Yield()，强制让方法立刻将控制权返回给Host，优先完成Windows服务的启动通知，再执行后续业务逻辑，修改后代码如下：

protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
    // 优先交回控制权，通知Windows服务启动成功
    await Task.Yield();
    try
    {
        // 原有业务逻辑保持不变
        using (var scope = _services.CreateScope())
        {
            File.AppendAllText("templogs.txt", "scope created\r\n");
            var actionHandler = scope.ServiceProvider.GetRequiredService<IActionHandler>();
            var dbContext = scope.ServiceProvider.GetRequiredService<DbContext>();
            // 原有剩余逻辑
        }
    }
    catch (Exception ex)
    {
        File.AppendAllText("templogs.txt", ex.Message + "\r\n");
    }
}

2. 替换同步数据库操作为异步实现 #

当前的数据库查询为同步执行，会阻塞线程，建议改为EF Core异步查询方法，避免阻塞启动流程：

// 替换原有同步查询写法
var activeStatuses = await dbContext.Statuses
    .Where(a => !_inactiveStatuses.Contains(a.Name))
    .ToDictionaryAsync(a => a.Id, a => a.Name, stoppingToken);
List<Guid> activeStatusGuids = activeStatuses.Keys.ToList();

3. 检查服务运行权限 #

• 确认Windows服务运行账户（默认一般为Local System）对程序所在目录有读写权限，避免日志写入、配置读取失败
• 如果数据库连接字符串使用Windows集成身份验证，请给服务运行账户分配对应数据库的访问权限，或改为SQL账号密码验证的连接字符串，避免权限不足导致数据库查询卡住

4. 确认依赖包安装 #

确保项目已安装和.NET版本匹配的Microsoft.Extensions.Hosting.WindowsServices NuGet包，该包是UseWindowsService()方法的必须依赖。

5. 可选优化 #

你代码中重写的StartAsync和StopAsync未添加自定义逻辑，可以直接删除，不影响功能运行。

验证方法 #

修改完成后重新编译，卸载原有服务后重新安装，启动后即可看到服务能正常被识别为运行状态，业务逻辑也会正常执行。

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