.NET优雅关闭停止事件中无法命中断点的问题

问题场景 #

在Visual Studio 2022（17.12.3）和Docker Desktop（4.36.0）环境下，调试带有Docker支持的默认Razor Pages项目时，后台服务MyBackgroundSvc的以下停止相关逻辑无法触发断点：

• IHostedLifecycleService接口的StoppingAsync、StoppedAsync方法
• IHostApplicationLifetime.ApplicationStopping注册的回调

启动相关事件（StartingAsync、StartedAsync）可正常命中断点并执行。

测试代码 #

Program.cs #

builder.Services.AddHostedService<MyBackgroundSvc>();

MyBackgroundSvc.cs #

public class MyBackgroundSvc(ILogger<MyBackgroundSvc> logger, 
                             IHostApplicationLifetime appLifetime) : BackgroundService, IHostedLifecycleService
{
    // 启动相关事件可执行，但停止相关事件不行
    
    public Task StartingAsync(CancellationToken cancellationToken)
    {
        logger.LogInformation("STARTING_ASYNC was called.");
        return Task.CompletedTask;
    }
    public Task StartedAsync(CancellationToken cancellationToken)
    {
        logger.LogInformation("STARTED_ASYNC was called.");
        return Task.CompletedTask;
    }
    public Task StoppingAsync(CancellationToken cancellationToken)
    {
        logger.LogInformation("STOPPING_ASYNC was called.");
        return Task.CompletedTask;
    }
    public Task StoppedAsync(CancellationToken cancellationToken)
    {
        logger.LogInformation("STOPPED_ASYNC was called.");
        return Task.CompletedTask;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        try
        {
            appLifetime.ApplicationStopping.Register(() =>
                    logger.LogInformation("APPLICATION_STOPPING was called.")
            );

            await Task.Delay(2000, stoppingToken);
        }
        catch (Exception ex)
        {
            logger.LogError(ex, "Error during ExecuteAsync work.");
        }
    }
}

解决方案 #

1. 发送优雅停止信号而非强制终止 #

直接点击Visual Studio工具栏的"停止调试"会强制终止Docker容器（发送SIGKILL信号），ASP.NET Core来不及处理停止事件。需改为：

• 在Docker Desktop中找到目标容器，右键选择Stop（而非"Force Stop"）
• 或在Visual Studio的"容器工具"窗口中，右键目标容器选择Stop

2. 检查Dockerfile的信号转发配置 #

确保Dockerfile使用的基础镜像支持信号转发，且启动命令正确。ASP.NET Core官方镜像默认支持，但自定义启动逻辑时需保证应用进程是PID 1，或使用tini工具转发信号。示例正确的Dockerfile入口配置：

ENTRYPOINT ["dotnet", "YourProject.dll"]

3. 先验证停止事件是否实际执行 #

若断点仍未命中，先通过Docker容器日志确认事件是否触发：

1. 在Docker Desktop中打开目标容器的Logs标签
2. 停止容器后，查看是否有STOPPING_ASYNC was called.、APPLICATION_STOPPING was called.日志
   • 若日志存在：说明事件正常执行，需检查Visual Studio调试附加设置
   • 若日志不存在：说明停止信号未传达到应用，需排查Docker配置

4. 调整Visual Studio调试停止行为 #

打开Visual Studio的调试->选项->调试->常规，取消勾选"停止调试时终止进程"，让调试器发送优雅停止信号给容器内的应用。

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