空Windows Service启动超时求助：sc.exe启动持续报错

1. 确认项目发布配置 #

你的Worker项目默认是控制台应用，但发布时需确保部署方式正确：

• 推荐使用自包含发布，避免目标机器缺失.NET运行时导致启动失败，执行命令：

  dotnet publish -c Release -r win-x64 --self-contained true
  

  该命令会将.NET运行时与程序打包在一起。

2. 检查sc.exe创建服务的命令语法 #

创建服务时必须严格遵循sc命令的语法要求，尤其是参数后的空格：

sc.exe create "MyWorkerService" binPath= "C:\完整路径\到\发布后的Worker.exe" start= auto

注意：binPath= 和 start= 后面必须跟一个空格，这是sc命令的硬性语法规则，遗漏空格会导致服务配置错误。

3. 添加日志排查启动失败原因 #

当前代码没有日志输出，无法定位启动时的具体错误。修改代码注入日志组件，输出关键信息：

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using System.Threading;
using System.Threading.Tasks;

var host = Host.CreateDefaultBuilder(args)
    .ConfigureServices((hostContext, services) =>
    {
        services.AddHostedService<Worker>();
    })
    .Build();

await host.RunAsync();

public class Worker : BackgroundService
{
    private readonly ILogger<Worker> _logger;

    public Worker(ILogger<Worker> logger)
    {
        _logger = logger;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        _logger.LogInformation("Worker服务启动于: {Time}", DateTimeOffset.Now);
        while (!stoppingToken.IsCancellationRequested)
        {
            _logger.LogInformation("Worker运行中: {Time}", DateTimeOffset.Now);
            await Task.Delay(1000, stoppingToken);
        }
        _logger.LogInformation("Worker服务停止于: {Time}", DateTimeOffset.Now);
    }
}

发布后，可通过Windows事件查看器（应用程序日志，来源为Microsoft.Hosting.Lifetime）查看启动时的错误日志，精准定位问题。

4. 验证程序本身可正常运行 #

先直接双击发布后的Worker.exe，确认程序能正常启动运行。如果手动运行报错，说明程序本身存在问题（如依赖缺失、代码错误），需先解决手动运行的问题再注册服务。

5. 检查服务账户权限（可选） #

默认sc创建的服务使用LocalSystem账户，权限足够覆盖大部分场景。如果程序需要访问特定资源（如网络、指定目录），可修改服务账户：

sc.exe config "MyWorkerService" obj= "DOMAIN\用户名" password= "密码"

同样注意obj=和password=后面的空格。

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