Blazor Server作为Windows服务运行时托管Web API报错

以下是针对该问题的排查和解决步骤：

• 检查URL绑定与端口权限
  直接运行exe时应用通常使用默认本地端口，但Windows服务运行时可能因未显式配置URL或权限不足无法监听端口。

  • 在Program.cs中显式指定可访问的URL：

    builder.WebHost.UseUrls("http://0.0.0.0:5000", "https://0.0.0.0:5001");
    

  • 给服务账户添加端口监听权限，以管理员身份运行命令提示符执行：

    netsh http add urlacl url=http://+:5000/ user=NT SERVICE\你的服务名称
    netsh http add urlacl url=https://+:5001/ user=NT SERVICE\你的服务名称
    

• 调整路由注册顺序
  Blazor端点路由的注册顺序会影响API路由匹配，需确保Web API路由优先注册：

  // 先注册Web API控制器路由
  app.MapControllers();
  // 再注册Blazor相关端点
  app.MapBlazorHub();
  app.MapFallbackToPage("/_Host");
  

• 验证环境配置一致性
  直接运行exe默认使用Development环境，Windows服务可能默认使用Production环境，导致配置差异：

  • 可在服务安装时添加环境变量ASPNETCORE_ENVIRONMENT=Development临时测试；
  • 检查appsettings.Production.json中的URL、路由相关配置是否与开发环境一致。

• 排查服务运行日志
  Windows服务的控制台日志不会直接显示，需配置日志输出到文件以定位问题：
  例如使用Serilog配置文件日志：

  Log.Logger = new LoggerConfiguration()
      .MinimumLevel.Information()
      .WriteTo.File("service-logs/log-.txt", rollingInterval: RollingInterval.Day)
      .CreateLogger();
  

  查看日志中是否有端口绑定失败、路由匹配错误等异常信息。

• 确认服务账户权限
  若API需要访问外部资源（如数据库、文件），默认Local System账户可能权限不足，可临时将服务账户改为Local Service或具有对应权限的用户账户测试。

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