启动ASP.NET Core 6.0.22服务时遭遇1053错误求解决方案

问题背景 #

启动名为“MyService”的Windows服务时触发1053错误：

Windows无法在本地计算机上启动“MyService”服务。
错误1053：服务未及时响应启动或控制请求。

该服务基于ASP.NET Core开发，包含每60秒执行ReadCycle方法的Worker后台任务，以及可手动触发该方法的API端点。直接运行.exe或在Visual Studio中调试时完全正常，仅作为Windows服务启动失败，推测问题出在Program.cs的服务托管配置上。

相关代码如下：

Program.cs #

public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);

    builder.Services.AddControllers();
    
    builder.Services.AddEndpointsApiExplorer();
    builder.Services.AddSwaggerGen();                        
    builder.Services.AddHostedService<Worker>();

    var app = builder.Build();

    // Configure the HTTP request pipeline.
    if (app.Environment.IsDevelopment())
    {
        app.UseSwagger();
        app.UseSwaggerUI();
    }

    app.UseHttpsRedirection();
    app.UseAuthorization();
    app.MapControllers();
    app.Run();
}

Worker.cs #

public class Worker : BackgroundService
{
    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        // 此处创建Oracle和SQL数据库连接类
        while (!stoppingToken.IsCancellationRequested)
        {
            ReadCycle();
            await Task.Delay(delaytime * 60 * 1000, stoppingToken);
        }
    }

    public void ReadCycle()
    {
        try
        {
            // 业务逻辑实现
        }
        catch (Exception ex)
        {
           // 异常日志记录
        }
    }
}

API控制器 #

public class Controller : ControllerBase
{
    private readonly IServiceProvider serviceProvider;

    public Controller(IServiceProvider serviceProvider)
    {
        this.serviceProvider = serviceProvider;
    }

    [HttpPost]
    public async Task<ActionResult<bool>> Post([FromBody]Model model)
    {
        var worker = serviceProvider.GetServices<IHostedService>()
                                    .OfType<Worker>()
                                    .FirstOrDefault();
        if (worker != null)
        {
            worker.ReadCycle();
            return CreatedAtAction("POST", true);
        }

        return CreatedAtAction("POST", false);                
    }
}

核心原因 #

Windows服务有严格的启动超时限制：必须在30秒内完成初始化并向系统返回启动成功信号。你的代码存在两个关键问题：

1. app.Run()会阻塞主线程启动Web服务器，作为Windows服务时，环境差异（如权限、网络、资源加载）可能导致启动超时；
2. Worker的ExecuteAsync方法在启动时直接创建数据库连接，若连接耗时过长，会拖慢整个服务的初始化流程。

修复方案 #

1. 切换为ASP.NET Core专用Windows服务托管模式 #

ASP.NET Core提供了原生的Windows服务托管API，能正确处理服务生命周期信号，避免主线程阻塞导致的超时。修改Program.cs如下：

public static async Task Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);

    // 配置为Windows服务托管模式
    builder.Host.UseWindowsService();

    builder.Services.AddControllers();
    
    builder.Services.AddEndpointsApiExplorer();
    builder.Services.AddSwaggerGen();                        
    builder.Services.AddHostedService<Worker>();

    var app = builder.Build();

    if (app.Environment.IsDevelopment())
    {
        app.UseSwagger();
        app.UseSwaggerUI();
    }

    app.UseHttpsRedirection();
    app.UseAuthorization();
    app.MapControllers();

    // 改用异步启动Web服务器，避免阻塞服务注册流程
    await app.RunAsync();
}

关键说明：

• UseWindowsService()会自动适配Windows服务的生命周期规范，确保系统能及时收到启动成功的反馈；
• 将Main改为异步方法并使用await app.RunAsync()，让框架更合理地调度线程，避免主线程被长时间占用。

2. 延迟Worker中的资源初始化 #

不要在ExecuteAsync开头直接创建数据库连接，将资源初始化延迟到第一次任务执行时，避免拖慢服务启动：

修改Worker.cs：

protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
    // 移除此处的数据库连接创建代码
    _logger.LogInformation("Worker已启动，等待首次任务执行");
    
    while (!stoppingToken.IsCancellationRequested)
    {
        await ReadCycleAsync(); // 改为异步方法
        await Task.Delay(delaytime * 60 * 1000, stoppingToken);
    }
}

// 改为异步方法，延迟初始化数据库连接
public async Task ReadCycleAsync()
{
    try
    {
        // 第一次执行时才创建并打开数据库连接
        using var oracleConn = new OracleConnection("你的Oracle连接字符串");
        using var sqlConn = new SqlConnection("你的SQL连接字符串");
        
        await oracleConn.OpenAsync();
        await sqlConn.OpenAsync();
        
        // 执行业务逻辑
    }
    catch (Exception ex)
    {
       _logger.LogError(ex, "ReadCycle执行失败");
    }
}

关键说明：

• 服务启动时，ExecuteAsync仅完成基础初始化并进入等待状态，让服务能快速向系统返回启动成功信号；
• 异步化ReadCycle方法，符合ASP.NET Core的异步编程规范，避免阻塞Worker线程。

3. 检查服务运行权限与工作目录 #

• 权限配置：确保服务使用的账户（默认是Local System）有访问数据库、文件系统等资源的权限。若数据库需要域账户认证，可在服务属性中切换登录账户；
• 工作目录：Windows服务默认工作目录为C:\Windows\System32，如果应用依赖相对路径的配置文件或资源，需在代码中指定绝对路径，或在服务属性中手动设置“启动目录”为应用程序所在路径。

4. 添加启动日志定位超时点 #

在Program.cs和Worker的关键节点添加日志，记录启动过程的耗时，精准定位超时环节：

// Program.cs中添加初始化日志
var logger = builder.Services.BuildServiceProvider().GetRequiredService<ILogger<Program>>();
logger.LogInformation("应用初始化开始");

// Worker的ExecuteAsync开头添加日志
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
    _logger.LogInformation("Worker初始化完成，开始执行循环任务");
    // ... 后续代码
}

关键说明：通过日志可以明确是Web服务器启动慢，还是Worker初始化慢，针对性优化对应环节。

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