如何让TopShelf服务的卸载事件在所有卸载方式下触发？

AI 小北

2026-8-12

如何让TopShelf服务在任何卸载方式下触发卸载前事件

问题背景

我用TopShelf创建了一个Windows服务，配置了BeforeUninstall事件来执行卸载前的逻辑（停止依赖此服务的其他服务）。但发现这个事件只在通过Cmd执行TopShelf自带的卸载命令时触发，用PowerShell的Remove-Service命令卸载时完全没反应。请问有没有办法让不管用哪种方式卸载服务，都能触发卸载前的处理逻辑？

核心原因

TopShelf的BeforeUninstall事件是绑定在它自身的卸载流程上的——只有当你通过TopShelf的宿主程序（比如YourService.exe uninstall）执行卸载时，才会触发这个自定义事件。而PowerShell的Remove-Service是直接调用Windows原生的DeleteService API，绕开了TopShelf的整个处理链，所以不会触发任何TopShelf层面的钩子。

可行解决方案

方案1：利用Windows服务原生依赖关系（推荐）

这是最可靠的系统级解决方案，不需要自己写复杂的逻辑：

将所有依赖当前服务的其他服务，配置为依赖当前服务（即把当前服务添加到这些服务的Dependencies列表中）。
当用户尝试卸载当前服务时，Windows服务控制管理器（SCM）会直接阻止操作，并弹出提示：“无法删除服务，因为有其他服务依赖于它”。
这种方式强制用户必须先停止/卸载那些依赖服务，才能完成当前服务的卸载，从根源上避免了依赖服务未停止就卸载的问题。

你可以通过TopShelf直接配置依赖：

HostFactory.Run(x =>
{
    x.Service<YourService>(s =>
    {
        s.ConstructUsing(name => new YourService());
        s.WhenStarted(tc => tc.Start());
        s.WhenStopped(tc => tc.Stop());
    });
    // 配置当前服务被哪些服务依赖（即其他服务依赖当前服务）
    x.DependedOnBy("DependencyService1");
    x.DependedOnBy("DependencyService2");
    x.RunAsLocalSystem();
    x.SetServiceName("YourMainService");
});

方案2：提供统一卸载入口，引导用户使用

如果需要自动停止依赖服务而不是让系统阻止卸载，可以提供一个统一的卸载脚本，引导用户通过这个脚本完成卸载：

编写一个PowerShell脚本（比如Uninstall-YourService.ps1）：

# 先执行TopShelf的卸载命令，触发BeforeUninstall事件
& "C:\Path\To\YourService.exe" uninstall

# 兜底检查：如果用户直接用Remove-Service，手动停止依赖服务
$service = Get-Service -Name "YourMainService" -ErrorAction SilentlyContinue
if (-not $service) {
    Stop-Service -Name "DependencyService1", "DependencyService2" -Force
}

在服务的安装文档、安装包中明确告知用户必须使用该脚本卸载，避免直接调用Remove-Service。

方案3：用WMI监听服务卸载事件（兜底方案）

如果必须兼容Remove-Service的场景，可以在服务启动时注册WMI事件监听器，监听当前服务的删除请求，一旦检测到就自动停止依赖服务：

using System.Management;
using System.ServiceProcess;

public class YourService
{
    private ManagementEventWatcher _watcher;

    public void Start()
    {
        // 注册WMI事件监听服务删除
        var query = new WqlEventQuery("SELECT * FROM __InstanceDeletionEvent WITHIN 1 WHERE TargetInstance ISA 'Win32_Service' AND TargetInstance.Name = 'YourMainService'");
        _watcher = new ManagementEventWatcher(query);
        _watcher.EventArrived += OnServiceDeletionDetected;
        _watcher.Start();
    }

    private void OnServiceDeletionDetected(object sender, EventArrivedEventArgs e)
    {
        StopDependencyServices();
        _watcher?.Stop();
    }

    private void StopDependencyServices()
    {
        // 停止依赖服务1
        using (var sc = new ServiceController("DependencyService1"))
        {
            if (sc.Status == ServiceControllerStatus.Running)
                sc.Stop();
        }
        // 同理处理其他依赖服务
        using (var sc = new ServiceController("DependencyService2"))
        {
            if (sc.Status == ServiceControllerStatus.Running)
                sc.Stop();
        }
    }

    public void Stop()
    {
        _watcher?.Stop();
    }
}

注意：这种方式是事后触发（服务已被标记为删除），但可以确保依赖服务被停止，不过无法阻止卸载操作本身。

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