首页/云/Docker 容器速查/ContainerConfig 报错:老 compose 读新镜像
容器排障52 条

ContainerConfig 报错:老 compose 读新镜像

老版 docker-compose(v1,Python 实现)读取较新构建工具产出的镜像元数据时会抛 KeyError: 'ContainerConfig';换用 Compose V2 或重拉镜像可解。

Docker 容器速查云更新于 2026-10-12
症状KeyError: 'ContainerConfig' 出现在 compose 启动栈里
根因v1 读取的镜像元数据缺旧字段
处置升级到 docker compose(v2)或调整构建/镜像来源

示例

示例
docker compose version
docker-compose version
docker compose -f compose.yaml up -d
docker pull registry.example.com/ns/app:1.0
历史 workaround 是 DOCKER_BUILDKIT=0 重建镜像,属于过渡手段,长期方案是升级工具链。

易错点

  • 报错栈里出现 ContainerConfig 时先确认命令是 docker-compose 还是 docker compose
  • 同一台机器并存 v1/v2 时,脚本里写死了哪个命令就决定了复现与否

数据来源与参考

  • Docker 官方文档:Compose V2 迁移说明(docs.docker.com/compose)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌