WiX MSI卸载时无法停止并移除.NET 8 Windows服务问题求助

可能的原因 #

1. 服务停止超时：MSI默认等待服务停止的时间为30秒，若你的.NET BackgroundService的StopAsync方法处理耗时过长，会导致MSI放弃停止操作，进而无法删除服务。
2. MajorUpgrade时序冲突：Schedule="afterInstallInitialize"的设置会让旧版本卸载在初始化后执行，可能与服务的停止/删除操作产生时序冲突。
3. ServiceControl配置冗余：Stop="both"会在安装时尝试停止服务（首次安装时服务未运行，无意义），且未明确设置超时时间，可能导致卸载时的停止逻辑异常。
4. .NET服务停止逻辑不完善：BackgroundService未正确实现StopAsync，未及时响应停止信号，导致系统无法正常终止服务。

解决方案 #

1. 完善.NET服务的停止逻辑 #

确保你的BackgroundService能快速响应停止请求，避免阻塞操作：

protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
    while (!stoppingToken.IsCancellationRequested)
    {
        // 业务逻辑，必须监听stoppingToken
        await Task.Delay(1000, stoppingToken);
    }
}

public override async Task StopAsync(CancellationToken cancellationToken)
{
    // 快速清理资源，避免长时间阻塞
    await base.StopAsync(cancellationToken);
}

2. 调整Wix的ServiceControl配置 #

优化服务控制逻辑，增加超时时间，明确仅在卸载时停止服务：

<ServiceControl
  Id="ServiceControl"
  Name="MyAppService"
  Start="install"
  Stop="uninstall"
  Remove="uninstall"
  Wait="yes"
  WaitTimeout="60000" /> <!-- 设置60秒超时，根据实际情况调整 -->

3. 调整MajorUpgrade的执行时序 #

将旧版本卸载的时机提前，避免时序冲突：

<MajorUpgrade AllowDowngrades="yes" Schedule="afterInstallValidate" />

4. 兜底方案：使用自定义动作调用sc.exe #

若上述方法无效，可添加自定义动作直接调用系统命令停止并删除服务：

<Fragment>
  <!-- 定义自定义动作 -->
  <CustomAction Id="StopServiceSC" Directory="INSTALLFOLDER" ExeCommand="sc stop MyAppService" Return="check" />
  <CustomAction Id="DeleteServiceSC" Directory="INSTALLFOLDER" ExeCommand="sc delete MyAppService" Return="check" />
  
  <!-- 绑定到卸载序列 -->
  <InstallExecuteSequence>
    <Custom Action="StopServiceSC" Before="RemoveFiles">REMOVE="ALL"</Custom>
    <Custom Action="DeleteServiceSC" Before="RemoveFiles">REMOVE="ALL"</Custom>
  </InstallExecuteSequence>
</Fragment>

5. 排查MSI日志定位问题 #

生成卸载日志，查看具体错误信息：

msiexec /x {你的产品GUID} /l*v uninstall.log

在日志中搜索ServiceControl、Stop、Remove等关键词，定位服务停止失败的具体原因。

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