ASP.NET Core SignalR应用部署为Windows服务启动报1053错误 手动运行正常

这个问题和SignalR框架本身没有直接关联，本质是普通ASP.NET Core WebHost程序直接被注册为Windows服务时，缺失了Windows服务必须的服务控制管理器（SCM）交互适配逻辑：

• 手动运行exe时，程序只是独立的控制台进程，没有SCM的托管约束，启动完成后正常监听请求即可，所以运行完全正常
• 被SCM托管启动时，SCM要求进程必须在30秒的超时窗口内，通过标准服务接口上报“启动完成”的状态信号。如果程序还是按照普通控制台的逻辑运行，根本不会主动对接SCM的通信接口，SCM收不到状态回执就会直接抛出1053超时错误

• 权限不足、依赖项缺失的问题可以直接排除：手动运行程序时哪怕是普通用户权限都能快速启动，说明程序本身的执行链路、依赖加载全链路正常，问题完全出在服务托管的适配层，和程序运行时的权限、依赖没关系
• 不存在SignalR启动慢触发超时的情况：哪怕你的WebHost1秒就能完成启动，只要没有对接SCM接口，SCM永远收不到启动完成的信号，必然触发1053报错

• 不要直接使用未做适配的普通WebHost发布版直接注册服务，需要在ASP.NET Core项目中引入官方托管扩展包Microsoft.Extensions.Hosting.WindowsServices
• 在主机构建逻辑中添加Windows服务适配调用，示例代码结构参考：

var builder = WebApplication.CreateBuilder(args);
// 原有业务服务注册逻辑，比如SignalR注册
builder.Services.AddSignalR();
// 新增Windows服务托管适配
builder.Host.UseWindowsService();

var app = builder.Build();
// 原有中间件、Hub路由映射逻辑
app.MapHub("/你的Hub路径");
app.Run();

• 重新通过Release配置发布后，使用原有的sc命令注册服务即可正常启动
• 这套官方扩展会自动处理所有SCM交互细节：进程被SCM拉起时自动切换为服务运行模式，启动过程中持续向SCM反馈状态、避免超时，启动完成后主动上报就绪信号，同时响应SCM发出的停止、暂停等控制指令，不需要手写原生服务交互代码

• 服务模式下默认的工作目录是C:\Windows\System32，官方扩展会自动将工作目录切换回exe所在路径，避免出现配置文件、静态资源读取失败的问题，不需要手动处理路径逻辑
• 不需要刻意调整SCM的30秒超时配置，只要适配层正常工作，哪怕WebHost启动需要20多秒，扩展也会持续给SCM发送“正在启动”的状态更新，不会触发超时判定
• 这类1053报错是所有未适配托管逻辑的ASP.NET Core程序直接注册为Windows服务时的通用问题，和是否使用SignalR没有关系，哪怕是无SignalR的普通Web API，直接注册都会出现一模一样的报错

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