Windows Worker Service启动超时问题排查求助

你的空Worker Service仍出现启动超时，说明问题不在业务代码，而是服务初始化、运行环境或系统配置层面，以下是针对性排查步骤：

1. 查看事件查看器的详细错误日志 #

打开事件查看器，依次定位到：

• Windows日志 -> 系统：查找Service Control Manager的错误事件（常见事件ID为7000或7009），日志会包含超时的具体上下文信息。
• 应用程序和服务日志 -> Microsoft -> Windows .NET Runtime：检查是否存在程序集加载失败、依赖缺失等初始化错误，这类问题会直接导致服务启动卡住。

2. 验证.NET运行时环境 #

如果服务是框架依赖发布的，确认部署机器已安装对应版本的.NET Runtime（如.NET 6/7/8）：

• 打开命令提示符，执行 dotnet --list-runtimes 查看已安装的运行时版本，确保和项目目标框架完全匹配。
• 如果是自包含发布，检查发布包是否完整，没有缺失核心文件。

3. 检查服务安装配置 #

用命令行验证服务的安装参数：

• 执行 sc qc <你的服务名称>，查看BINARY_PATH_NAME是否正确：若路径包含空格，必须用引号包裹（例如 "C:\Program Files\MyService\MyService.exe"），缺少引号会导致启动命令解析失败。

4. 以控制台模式运行服务 #

修改Program.cs，临时注释掉.UseWindowsService()，重新发布后直接双击exe运行：

IHost host = Host.CreateDefaultBuilder(args)
    .ConfigureServices(services =>
    {
        services.AddHostedService<Worker>();
    })
    //.UseWindowsService() // 临时注释
    .Build();

await host.RunAsync();

此时可直接在控制台看到报错信息，比如配置文件缺失、权限不足、依赖加载失败等。

5. 检查程序目录权限 #

即使服务以Local System身份运行，若程序所在目录权限异常，也会导致无法读取程序集或配置文件：

• 右键程序目录，选择「属性 -> 安全 -> 编辑」，添加「Local System」账户，授予完全控制权限，应用后重启服务测试。

6. 确认ServicesPipeTimeout注册表项配置正确 #

确保注册表项设置无误：

• 路径：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control
• 键名：ServicesPipeTimeout，类型为DWORD（32位），值设为180000（十进制，即3分钟）
• 修改后必须重启机器才会生效，仅重启服务无法触发配置更新。

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