软件更新后Docker Compose LAMP栈报‘ContainerConfig’错误的排查与解决

问题背景 #

服务器及Docker镜像、容器更新后，Docker Compose部署的LAMP栈出现异常：Apache和MySQL容器能正常启动，但PHP与phpMyAdmin容器始终报ContainerConfig错误。环境为Docker 26.0.0、docker-compose 1.29.2，尝试更换PHP/PMA版本、简化docker-compose.yml配置都没能解决问题。

排查关键点 #

经过测试，核心问题出在命令工具兼容性和配置文件的版本适配上：旧版的docker-compose（带横杠）命令与Docker 26.0.0的兼容性较差，同时配置中的version字段和网络设置也会引发冲突。

解决步骤 #

1. 切换命令工具
   放弃使用旧版的docker-compose命令，改用Docker官方整合的docker compose（无横杠）命令——两者的版本迭代路径不同，新版工具对高版本Docker的支持更完善。

2. 调整docker-compose.yml配置

   • 移除配置文件顶部的version字段：新版Docker Compose已不再强制要求该字段，旧版本号会与Docker 26.0.0产生兼容性冲突。
   • 统一容器网络配置：确保所有LAMP服务容器都加入同一自定义网络，避免默认网络的隔离问题。示例配置片段：

     services:
       apache:
         # 其他配置...
         networks:
           - lamp-net
       mysql:
         # 其他配置...
         networks:
           - lamp-net
       php:
         # 其他配置...
         networks:
           - lamp-net
       phpmyadmin:
         # 其他配置...
         networks:
           - lamp-net
     networks:
       lamp-net:
         driver: bridge
     

3. 清理Docker冗余资源
   执行以下命令清理残留的容器、镜像、网络和卷，彻底清除旧环境的干扰：

   # 停止并删除当前服务的容器及关联卷
   docker compose down -v
   # 清理所有未使用的Docker资源（谨慎执行，会删除所有闲置资源）
   docker system prune -af
   

4. 重新部署服务
   用新版命令启动服务：

   docker compose up -d
   

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