合并Docker Compose YAML文件遇服务冲突报错

Docker Compose 用 include 引入外部文件时，默认逻辑是组合不同文件的服务列表，而非合并单个服务的配置项。如果当前文件和被引入文件存在同名服务，它会直接判定为配置冲突，不会自动合并——哪怕你使用的是2.20+版本。

要实现单个服务的配置合并，需用 extends 关键字继承基础服务的配置，再叠加额外参数。把你的 prod/compose.yaml 修改为：

services:
  hello-world:
    extends:
      file: ../common/compose.yaml
      service: hello-world
    environment:
      - name=value

修改后执行 docker compose up 即可正常启动，common 文件中的镜像配置会和 prod 文件中的环境变量配置合并生效。

如果坚持使用 include，2.20+版本也支持通过配置 merge 策略实现合并，写法如下：

include:
  - path: ../common/compose.yaml
    merge: true
services:
  hello-world:
    environment:
      - name=value

不过这种方式的兼容性不如 extends 稳妥，推荐优先使用 extends，逻辑更直观清晰。

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