.NET 6应用部署在AKS中无法处理SIGTERM实现优雅关闭的问题

核心排查点与修复步骤 #

1. 修正Dockerfile的ENTRYPOINT格式 #

如果你的Dockerfile使用shell形式的ENTRYPOINT，容器的PID 1会是shell进程而非.NET应用进程，SIGTERM信号会被shell拦截，无法传递给.NET程序。必须改为exec形式：

# 错误示例（shell模式）
# ENTRYPOINT dotnet YourBackgroundService.dll

# 正确示例（exec模式）
ENTRYPOINT ["dotnet", "YourBackgroundService.dll"]

同时保留STOPSIGNAL SIGTERM配置，确保K8s发送正确的终止信号。

2. 确保BackgroundService监听取消令牌 #

BackgroundService必须正确响应取消请求，否则即使ApplicationStopping触发，作业也无法正常收尾。在ExecuteAsync方法中绑定传入的CancellationToken，并在作业执行过程中检查令牌状态：

protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
    while (!stoppingToken.IsCancellationRequested)
    {
        // 将取消令牌传递给耗时作业逻辑
        await RunScheduledJobAsync(stoppingToken);
        
        // 等待下一次触发时监听取消信号
        await Task.Delay(TimeSpan.FromMinutes(5), stoppingToken);
    }

    // 添加作业收尾逻辑，等待正在运行的子任务完成
    await CleanupRunningJobsAsync();
}

3. 调整AKS Pod的终止宽限期 #

默认K8s给Pod的终止宽限期是30秒，若作业执行时间超过这个值，K8s会直接强制杀死Pod，导致优雅关闭逻辑来不及执行。在Deployment的YAML中设置更长的宽限期：

apiVersion: apps/v1
kind: Deployment
spec:
  template:
    spec:
      terminationGracePeriodSeconds: 120 # 根据实际作业耗时调整，例如设为120秒
      containers:
      - name: your-app-container
        image: your-image:tag

4. 验证信号传递是否正常 #

在AKS中进入运行中的Pod，手动发送SIGTERM信号测试：

# 进入Pod
kubectl exec -it <pod-name> -- /bin/sh

# 找到.NET应用的进程ID（PID）
ps aux

# 发送SIGTERM信号
kill -15 <dotnet-pid>

若此时OnAppStopping方法触发，说明信号传递正常，问题可能出在K8s终止流程配置；若仍未触发，检查Dockerfile和.NET应用的信号处理逻辑。

5. 检查IHostApplicationLifetime的注册是否正确 #

确保ApplicationStopping事件在应用启动时注册，例如在BackgroundService的构造函数中：

public class YourBackgroundService : BackgroundService
{
    private readonly IHostApplicationLifetime _applicationLifetime;

    public YourBackgroundService(IHostApplicationLifetime applicationLifetime)
    {
        _applicationLifetime = applicationLifetime;
        _applicationLifetime.ApplicationStopping.Register(OnAppStopping);
    }

    private void OnAppStopping()
    {
        // 优雅关闭逻辑，例如记录日志、标记作业状态等
        Console.WriteLine("Application is stopping, cleaning up jobs...");
    }

    // 其他方法...
}

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