.NET 7中如何正确退出ServiceBase实现的服务进程？

问题根源分析 #

• 加Environment.Exit(0)报Error 1067：ServiceBase的OnStop由服务控制管理器（SCM）触发，正常流程是OnStop执行完成后，SCM会确认服务已正常停止。直接调用Environment.Exit会强制终止进程，SCM未收到预期的正常停止信号，因此抛出进程意外终止的错误。
• 不加Environment.Exit进程残留：服务内部存在未被正确终止的后台任务、前台线程或未释放的资源，这些会阻止进程在服务停止后自动退出。

解决方案 #

1. 用CancellationToken管理后台任务

在服务启动时创建CancellationTokenSource，将令牌传入后台任务；停止服务时触发取消信号并等待任务完成，确保所有业务逻辑线程正常终止。示例代码：

private CancellationTokenSource _serviceCts;

protected override void OnStart(string[] args)
{
    _serviceCts = new CancellationTokenSource();
    // 启动后台业务任务
    Task.Run(async () =>
    {
        try
        {
            while (!_serviceCts.Token.IsCancellationRequested)
            {
                // 执行你的业务逻辑
                await Task.Delay(2000, _serviceCts.Token);
            }
        }
        catch (OperationCanceledException)
        {
            // 捕获取消异常，做必要的清理
        }
    }, _serviceCts.Token);
}

protected override void OnStop()
{
    // 触发取消信号
    _serviceCts?.Cancel();
    // 释放资源
    _serviceCts?.Dispose();
}

2. 处理前台线程

如果使用原生Thread而非Task，默认创建的是前台线程，前台线程会阻止进程退出。需将线程设为后台线程，或在OnStop中主动终止：

private Thread _workerThread;
private volatile bool _shouldStop;

protected override void OnStart(string[] args)
{
    _workerThread = new Thread(DoWork)
    {
        IsBackground = true // 设置为后台线程，主线程结束时自动终止
    };
    _workerThread.Start();
}

private void DoWork()
{
    while (!_shouldStop)
    {
        // 业务逻辑
        Thread.Sleep(1000);
    }
}

protected override void OnStop()
{
    _shouldStop = true;
    _workerThread?.Join(5000); // 等待线程终止，超时则强制放弃
}

3. 清理未释放资源

检查服务中是否存在未关闭的数据库连接、文件流、网络套接字等资源，在OnStop方法中确保所有资源被正确释放，避免因资源占用导致进程无法退出。

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