如何用WIX/VS安装项目构建.NET Core 7 Worker Service的Windows服务MSI

一、修复WIX安装项目启动失败问题 #

你的WIX安装报错，核心原因是.NET Core Worker Service的服务注册逻辑与.NET Framework服务存在差异，按以下步骤调整配置：

1. 修正WIX服务配置代码 #

确保WIX的ServiceInstall和ServiceControl元素配置匹配.NET Core服务的要求，示例代码如下：

<Component Id="PrithWorkerServiceComponent" Guid="YOUR-GUID-HERE">
  <File Id="PrithWorkerServiceExe" Source="$(var.PrithWorkerService.TargetDir)PrithWorkerService.exe" KeyPath="yes" />
  
  <!-- 服务安装核心配置 -->
  <ServiceInstall
    Id="PrithWinServiceInstall"
    Name="PrithWinService"
    DisplayName="Prith Worker Service"
    Description="Prith .NET Core后台服务"
    Start="auto"
    Account="LocalSystem" <!-- 按需选择权限账户，如NetworkService -->
    ErrorControl="normal"
    Type="ownProcess" />
  
  <!-- 服务生命周期控制 -->
  <ServiceControl
    Id="PrithWinServiceControl"
    Name="PrithWinService"
    Start="install"
    Stop="both"
    Remove="uninstall"
    Wait="yes" />
</Component>

• 注意：Account属性若使用LocalSystem可确保权限充足，若需最小权限可改用NetworkService或自定义域账户。

2. 排查服务启动失败的深层原因 #

报错提示的权限问题可能是假象，优先排查以下内容：

• 打开Windows事件查看器，在应用程序和服务日志 > Prith Service（你配置的日志名称）中查看具体启动错误，比如依赖缺失、代码异常。
• 直接运行安装目录下的服务EXE文件，验证是否能正常启动，排查运行时错误。
• 确保发布的是自包含部署包：在项目发布设置中选择“自包含”，或用命令行发布：dotnet publish -c Release -r win-x64 --self-contained true，避免目标机器缺少.NET Core运行时。

二、修复Visual Studio安装项目未注册服务问题 #

VS安装项目默认不会自动注册.NET Core Worker Service，可通过添加自定义操作实现自动注册：

1. 右键安装项目 → 视图 → 自定义操作
2. 在“安装”节点右键 → 添加自定义操作 → 选择Worker Service的EXE文件
3. 修改该自定义操作属性：
   • Arguments设为 install（.NET Core Worker Service自带服务注册命令）
   • InstallerClass设为False
4. 同理，在“卸载”节点添加相同EXE文件，Arguments设为 uninstall

注：启用UseWindowsService()的.NET Core Worker Service，自带install/uninstall/start/stop等命令行注册能力。

三、轻量替代方案：命令行脚本注册服务 #

如果不想使用安装项目，可通过Windows命令行直接注册服务，将命令写成批处理脚本即可：

• 注册服务：sc create "PrithWinService" binPath= "C:\你的服务路径\PrithWorkerService.exe" start= auto
• 启动服务：sc start "PrithWinService"
• 卸载服务：sc delete "PrithWinService"

四、关于System.Configuration.Install的说明 #

.NET Core已移除对System.Configuration.Install.Installer的支持，这是.NET Framework的旧机制。.NET Core Worker Service通过Microsoft.Extensions.Hosting.WindowsServices包提供服务能力，自带命令行注册功能，无需依赖旧组件。

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