Spring Boot 3.2.3集成Docker Compose启动失败求助

核心原因 #

Gradle运行bootRun时的环境变量PATH和终端手动执行命令时的不一致，导致Spring Boot无法定位到docker可执行文件。

解决方案 #

1. 验证Gradle运行时的PATH #

先确认Gradle进程能访问的PATH：
在build.gradle中添加临时任务：

task printRuntimePath {
    doLast {
        println "Gradle runtime PATH: ${System.getenv('PATH')}"
    }
}

执行命令：

./gradlew printRuntimePath

将输出与终端执行echo $PATH的结果对比，通过which docker获取docker所在目录，确认该目录是否在Gradle的PATH中。

2. 手动指定Docker CLI路径 #

如果Gradle的PATH里没有docker所在目录，直接在配置文件中指定docker的绝对路径：
在src/main/resources/application-dev.properties（对应你的dev环境）中添加：

spring.docker.compose.cli-path=/usr/bin/docker

注意：替换为which docker输出的实际路径

3. 确保Gradle继承终端环境变量 #

• 终端运行时，禁用Gradle守护进程避免缓存旧环境：

./gradlew bootRun --no-daemon

或者强制传递当前终端的PATH：

PATH=$PATH ./gradlew bootRun

• IDE运行时，检查IDE的运行配置，确保勾选包含系统环境变量选项，让IDE将终端的PATH传递给Gradle进程。

4. 检查Docker安装位置 #

确保docker安装在系统级目录（如/usr/bin），而非用户私有目录（如~/bin）。如果是用户目录，需将该目录添加到Gradle环境变量中，或直接通过cli-path指定路径。

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