将Web应用作为Windows服务运行时无法连接localhost的问题

1. 检查服务账户的权限 #

Windows服务默认使用Local System账户运行，和直接运行exe时的当前用户权限存在差异，可能导致端口监听或SSL证书访问失败：

• SSL证书权限：打开certlm.msc找到你的HTTPS证书，右键→「所有任务」→「管理私钥」，添加NT AUTHORITY\SYSTEM账户并赋予读取权限。
• 端口预留：用netsh命令给服务账户预留端口权限：

  netsh http add urlacl url=https://+:5011/ user="NT AUTHORITY\SYSTEM"
  netsh http add urlacl url=http://+:5011/ user="NT AUTHORITY\SYSTEM"
  

2. 确认单文件发布的配置读取正常 #

单文件发布时，配置文件可能被嵌入或服务运行时无法读取到正确路径：

• 在Program.cs中明确指定配置文件路径，确保服务能读取到settings.json：

  builder.Configuration
         .SetBasePath(AppContext.BaseDirectory)
         .AddJsonFile("settings.json", optional: false, reloadOnChange: true);
  

• 发布时添加参数确保所有内容被正确提取：

  dotnet publish -c Release --self-contained --runtime win-x64 -p:PublishSingleFile=true -p:IncludeAllContentForSelfExtract=true
  

3. 排查服务启动日志 #

通过日志定位启动时的错误：

• 在Program.cs中添加文件日志输出：

  builder.Logging.AddFile(Path.Combine(AppContext.BaseDirectory, "logs/service.log"));
  

• 打开Windows事件查看器，查看「Windows日志→应用程序」中的服务相关错误信息。

4. 修正服务安装脚本 #

安装脚本的binPath如果包含空格需要加引号，同时确保服务工作目录正确：

• 修改installer.bat的sc create命令，给路径加上引号：

  sc create TestService binPath= "\"%~dp0MyProgram.exe\""
  sc failure TestService actions= restart/60000/restart/60000/""/60000 reset= 86400
  sc start TestService 
  sc config TestService start=auto
  

5. 检查HTTPS证书绑定 #

确认端口5011的SSL证书绑定正确：

• 用以下命令查看现有绑定：

  netsh http show sslcert
  

• 如果没有绑定，执行以下命令添加（替换certhash为你的证书指纹，appid为任意GUID）：

  netsh http add sslcert ipport=0.0.0.0:5011 certhash=ABC123DEF456... appid={12345678-1234-1234-1234-1234567890AB}
  

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