Python脚本无法删除已停止容器关联的Docker镜像求助

你的脚本里镜像删除失败有两个核心原因：

1. 容器已被删除，无法通过docker ps获取镜像信息
   你先执行了docker-compose down，这个命令默认会停止并删除所有关联容器，之后再用docker ps -aq根本找不到这些容器，自然拿不到镜像ID，删除步骤直接跳过。

2. 容器名称过滤规则错误
   Docker Compose生成的容器名称格式是[项目名]-[服务名]-[序号]，项目名默认是当前目录的名字，不是你用的compose_file.stem（也就是docker-compose），所以--filter name={compose_file.stem}根本匹配不到任何容器。

解决方法 #

方法一：用Docker Compose直接管理镜像（最简单） #

docker-compose down本身支持--rmi参数，可以直接删除服务关联的镜像，不需要手动去查：

• --rmi all：删除所有服务使用的镜像（包括构建的镜像和拉取的镜像）
• --rmi local：只删除本地构建的镜像

修改你的脚本，把down命令改成：

subprocess.run(["docker-compose", "-f", compose_file, "down", "--rmi", "local"], check=True)

这样执行down的时候就会自动删除本地构建的镜像，不需要后面的镜像删除逻辑。

方法二：手动获取镜像并删除（更灵活） #

如果需要保留手动删除的逻辑，要在删除容器之前先获取镜像信息，并且用正确的过滤规则：

修改后的docker_operations.py代码：

import subprocess
from pathlib import Path

def stop_and_remove_container_from_compose(compose_file):
    try:
        # 先获取关联的镜像ID（在删除容器之前）
        image_ids = subprocess.check_output(
            ["docker-compose", "-f", compose_file, "images", "-q"]
        ).decode().splitlines()
        
        # 停止并删除容器（down已经包含stop和rm的操作，不需要额外执行rm）
        subprocess.run(["docker-compose", "-f", compose_file, "down"], check=True)
        print(f"Containers stopped and removed successfully using Docker Compose: {compose_file}")

        # 删除镜像，加-f强制删除（避免镜像被引用时删除失败）
        for image_id in image_ids:
            if image_id:  # 跳过空行
                subprocess.run(["docker", "image", "rm", "-f", image_id], check=True)
        print("Docker images deleted successfully")
    except subprocess.CalledProcessError as e:
        print(f"An error occurred: {e}")

# Example usage
compose_file = Path("docker-compose.yaml")
stop_and_remove_container_from_compose(compose_file)

额外注意点 #

• docker-compose rm -fsv是多余的，docker-compose down已经会停止并删除容器、网络等资源，不需要重复执行。
• 删除镜像时加上-f参数，可以强制删除被停止容器引用的镜像（如果镜像没有其他活跃引用的话）。
• 如果你的镜像有标签（比如web:latest），删除时用标签或者镜像ID都可以，但ID更准确。

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