使用Docker.DotNet删除容器成功后抛出ContainerNotFoundException问题

安全阿岳

2026-10-11

问题诱因

遍历的容器列表为静态过期快照：RunningContainers是代码执行前获取的固定集合，仅保留了获取瞬间的容器状态。在遍历执行过程中，除了当前代码删除的容器外，可能存在其他外部操作（比如运维操作、其他服务逻辑、定时任务）已经提前删除了列表中的对应容器，当代码执行到InspectContainerAsync或RemoveContainerAsync时，目标容器已经不存在，Docker Engine就会返回No such container错误。
异步方法同步阻塞引发时序异常：代码使用.Result和.Wait()强行阻塞Docker.DotNet的异步API，这种写法破坏了异步方法的执行时序，在带同步上下文的环境（比如ASP.NET、WPF）中还可能引发死锁或响应消费异常，部分场景下会出现删除请求已经实际执行成功，但底层HTTP客户端的响应处理逻辑混乱，后续复用连接发起其他容器操作时错误返回前序的404结果。
缺少Docker API错误的兼容逻辑：代码未对Docker API返回的404状态做兼容捕获，只要目标容器不存在就会直接抛出未处理异常，即使是正常的“删除已不存在的容器”场景也会中断执行。

解决方案

改用全异步写法，避免同步阻塞
将.Result、.Wait()替换为await，符合Docker.DotNet的异步设计，避免时序和死锁问题，同时新增404异常捕获逻辑，参考代码如下：

foreach (var container in RunningContainers)
{
    if (container.State is "dead" or "exited")
    {
        try
        {
            var inspectResult = await Client.Containers.InspectContainerAsync(container.ID);
            long exitType = inspectResult.State.ExitCode;
            if (exitType != 0)
            {
                badExitCodeCount++;
            }
            await Client.Containers.RemoveContainerAsync(container.ID, new ContainerRemoveParameters());
        }
        catch (DockerApiException ex) when (ex.StatusCode == System.Net.HttpStatusCode.NotFound)
        {
            // 容器已不存在，属于预期场景，直接跳过
            continue;
        }
    }
}

操作前校验最新容器状态
如果对数据一致性要求较高，可以在执行批量删除前重新拉取一次最新的容器列表，避免使用过期列表操作已经被删除的容器。
禁止后续逻辑复用过期容器集合
本次删除操作执行完成后，如果后续还有其他容器操作逻辑，需要重新调用ListContainersAsync拉取最新的容器列表，不要继续使用本次的旧RunningContainers集合。

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