Spring Boot集成Docker Compose报错：services必须为映射类型

我通过Spring Initializer创建了添加Docker Compose Support的Spring Boot应用，生成的项目中compose.yaml文件为空（尚未添加任何配置）。在IntelliJ IDE中尝试运行应用时，出现如下错误：

Stderr:
validating ..../compose.yaml: services must be a mapping

    at org.springframework.boot.docker.compose.core.ProcessRunner.run(ProcessRunner.java:96) ~[spring-boot-docker-compose-3.3.0-20240301.111245-172.jar:3.3.0-SNAPSHOT]
    at org.springframework.boot.docker.compose.core.DockerCli.run(DockerCli.java:80) ~[spring-boot-docker-compose-3.3.0-20240301.111245-172.jar:3.3.0-SNAPSHOT]

错误原因 #

这个错误的核心是空的compose.yaml不符合Docker Compose的配置规范：

• Docker Compose要求配置文件必须包含services节点，且该节点是键值对形式的映射结构，用来声明要运行的容器服务；
• Spring Boot 3.2+的Docker Compose插件会在应用启动前自动调用Docker Cli验证compose.yaml的合法性，空文件无法通过校验，直接触发验证失败错误；
• 插件的设计逻辑是启动时必须加载有效的服务配置，空配置无法满足插件的前置要求，导致启动流程中断。

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