docker-compose启动报错提示依赖的mysql服务未定义该如何解决？

这个报错是Docker Compose在配置文件解析阶段抛出的（还没到启动容器、执行健康检查的环节，所以报错速度极快），常见原因有两个：

1. YAML 格式/缩进错误 #

YAML语法对缩进要求极其严格，必须使用空格缩进（禁止使用Tab键），且层级对齐必须准确：

• 检查mysql:行的缩进层级，它必须是services:下的二级节点，和同层级的web:前面的空格数完全一致
• 确认mysql:行前后没有不可见的特殊字符，这类字符会导致Compose无法识别到你定义了mysql服务
  你可以把配置内容复制到在线YAML校验工具中，先确认格式合法性。

2. Compose版本与配置语法不兼容 #

你使用的3.7版本的Compose配置规范，本身不支持depends_on下的condition参数：这个参数在3.0~3.8版本的Compose规范中被临时移除，仅在2.x旧版本、3.9及以上版本，以及新版Compose V2（docker compose不带横杠的命令）中支持。旧版本Compose解析到你写的带condition的依赖语法时会出现解析异常，误以为你依赖的mysql服务未定义。 #

你可以任选一种适配方案：

• 方案一：适配新版Compose规范
  升级Docker Compose到最新的V2版本，同时将配置文件首行的version: "3.7"改为version: "3.9"，也可以直接删除version声明（新版Compose规范已经不需要显式指定版本）。
• 方案二：降级依赖写法适配旧版本
  去掉depends_on的condition参数，改为最简依赖写法，同时在web服务的启动逻辑中增加等待MySQL就绪的判断（比如用wait-for-it工具检测3306端口连通性后再启动httpd），修改后的web服务依赖配置如下：

  depends_on:
    - mysql
  

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