.NET 8容器实例优雅关闭问题：Azure停止后无法完成收尾逻辑

问题描述 #

在Azure上以Linux容器镜像运行无Dockerfile的.NET 8控制台应用，应用包含多个托管服务。需要在应用停止时执行优雅关闭（将少量数据持久化到数据库），但在Azure门户容器实例层级点击「停止」按钮后，应用会立即终止——托管服务的StopAsync方法虽被调用，但停止逻辑还没完成就被关闭。尝试使用IHostApplicationLifetime的代码如下，其中10秒延迟并未生效：

// 等待所有IHostedServices完成停止逻辑
// 10秒延迟未被执行
_applicationLifetime.ApplicationStopping.Register(async () => await Task.Delay(10_000));

请问如何让应用在点击停止按钮后不立即关闭？是否需要使用其他停止方法？

解决方案 #

1. 修复ApplicationStopping的异步注册问题 #

ApplicationStopping.Register不支持自动等待异步委托完成，它只会执行异步方法的同步启动部分就返回，导致你的延迟逻辑被丢弃。需要改为同步阻塞等待异步任务完成：

_applicationLifetime.ApplicationStopping.Register(() =>
{
    // 执行优雅关闭逻辑并等待完成
    Task.Run(async () =>
    {
        await PersistPendingDataAsync(); // 替换为你的数据持久化逻辑
        await Task.Delay(10_000); // 测试用延迟
    }).Wait();
});

2. 配置Azure容器实例的停止超时 #

Azure容器实例默认停止超时为10秒，若你的关闭逻辑需要更长时间，必须在部署时设置更长的超时值：

• 使用Azure CLI部署时添加参数：

az container create \
  --resource-group <你的资源组名> \
  --name <你的容器实例名> \
  --image <你的镜像地址> \
  --stop-timeout 30

这里将超时设置为30秒，确保有足够时间完成关闭逻辑。

3. 正确实现托管服务的StopAsync #

确保IHostedService的StopAsync方法内的所有异步操作都被正确等待，避免逻辑未完成就返回：

public class DataPersistHostedService : IHostedService
{
    public async Task StartAsync(CancellationToken cancellationToken)
    {
        // 启动服务逻辑
    }

    public async Task StopAsync(CancellationToken cancellationToken)
    {
        // 执行数据持久化
        await SavePendingDataToDbAsync(cancellationToken);
        // 确保所有操作完成后再返回
        await Task.Delay(5000, cancellationToken);
    }
}

4. 配置主机关闭超时 #

在Program.cs中明确设置主机的关闭超时，确保.NET运行时给足时间处理关闭逻辑：

var host = Host.CreateDefaultBuilder(args)
    .ConfigureServices(services =>
    {
        services.AddHostedService<DataPersistHostedService>();
    })
    .ConfigureHostOptions(options =>
    {
        options.ShutdownTimeout = TimeSpan.FromSeconds(30);
    })
    .Build();

await host.RunAsync();

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