Docker-compose down会终止应用？如何优雅停止无限循环.NET应用？

你的问题很典型：因为你的控制台应用没有处理Docker发送的优雅终止信号（SIGTERM），所以docker-compose down -t 5等5秒超时后，Docker只能强制杀掉进程（发送SIGKILL）。下面是具体的解决思路和代码修改方案：

问题根源 #

Docker在执行优雅停止时，会先给容器内的主进程发送SIGTERM信号，告诉应用"准备好退出"，等待指定的超时时间（这里是5秒）。如果应用没响应这个信号，Docker就会发送SIGKILL强制终止进程。

而你的原始代码是一个无限循环，既没有监听终止信号，Thread.Sleep(500)又是阻塞调用，完全无法感知外部的终止请求，自然不会优雅退出。

解决方案：让应用监听终止信号并优雅退出 #

我们需要修改代码，添加信号处理逻辑，同时将阻塞的Thread.Sleep替换为能响应取消信号的调用，让应用在收到终止信号时可以干净地退出循环。

修改后的代码示例 #

using System;
using System.Threading;
using System.Threading.Tasks;

public static class Program
{
    private static readonly CancellationTokenSource _cts = new CancellationTokenSource();

    public static void Main()
    {
        // 注册信号处理：捕获SIGINT（Ctrl+C）和SIGTERM（Docker优雅停止信号）
        Console.CancelKeyPress += (sender, e) =>
        {
            e.Cancel = true; // 阻止系统立即终止进程
            _cts.Cancel();
            Console.WriteLine("Received stop signal, starting graceful shutdown...");
        };

        // 兜底处理：进程即将退出时触发
        AppDomain.CurrentDomain.ProcessExit += (sender, e) =>
        {
            _cts.Cancel();
            Console.WriteLine("Cleaning up before exit...");
        };

        int i = 0;
        try
        {
            // 循环检查取消信号，未取消则继续执行
            while (!_cts.Token.IsCancellationRequested)
            {
                Console.WriteLine("Hey {0}", i++);
                // 用Task.Delay替代Thread.Sleep，支持响应取消信号
                Task.Delay(500, _cts.Token).Wait(_cts.Token);
            }
        }
        catch (OperationCanceledException)
        {
            // 捕获取消异常，正常退出流程
            Console.WriteLine("Application exited gracefully.");
        }
    }
}

关键修改点解释 #

1. CancellationTokenSource：用来管理取消信号，当收到终止请求时，调用Cancel()通知所有监听的代码。
2. Console.CancelKeyPress事件：在Linux/macOS下会捕获SIGTERM信号（Docker发送的），在Windows下捕获Ctrl+C，通过e.Cancel = true阻止系统直接终止进程，让我们自己控制退出流程。
3. Task.Delay替代Thread.Sleep：Thread.Sleep是完全阻塞的，即使收到取消信号也不会醒来；而Task.Delay结合CancellationToken，会在收到取消信号时立即抛出OperationCanceledException，触发循环退出。

Dockerfile的重要注意点 #

确保你的Dockerfile使用exec形式的ENTRYPOINT，而不是shell形式，这样应用进程会成为容器的PID 1，才能直接接收Docker发送的信号。

示例Dockerfile（以.NET 6为例）：

# 基础镜像
FROM mcr.microsoft.com/dotnet/runtime:6.0 AS base
WORKDIR /app

# 构建阶段
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["YourAppName.csproj", "."]
RUN dotnet restore "./YourAppName.csproj"
COPY . .
RUN dotnet build "YourAppName.csproj" -c Release -o /app/build

# 发布阶段
FROM build AS publish
RUN dotnet publish "YourAppName.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 最终镜像
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
# 用exec形式的ENTRYPOINT，确保信号直接传递给应用进程
ENTRYPOINT ["dotnet", "YourAppName.dll"]

测试验证 #

1. 重新构建镜像：docker-compose build
2. 启动容器：docker-compose up -d
3. 执行优雅停止：docker-compose down -t 5

此时你会在日志中看到应用输出停止提示，然后正常退出，不会等到5秒超时被强制杀掉。

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