Gradle执行docker命令提示找不到文件的原因及解决方法

问题原因 #

Mac M1设备上，直接在终端运行docker正常，但通过Gradle的Exec任务调用时提示找不到命令，核心原因是Gradle进程的环境变量PATH不包含/usr/local/bin。

终端运行命令时，shell会加载完整的自定义环境变量（比如从~/.zprofile、~/.bash_profile等登录脚本中读取PATH配置），但Gradle的gradlew脚本如果在非登录shell环境下运行（比如IDE启动的进程），或者脚本本身未继承终端的完整PATH，就会只使用系统默认的PATH（/usr/bin:/bin:/usr/sbin:/sbin），而Docker恰好安装在不在默认PATH里的/usr/local/bin目录下，导致找不到命令。

解决方法 #

方法一：让终端以登录shell运行Gradle #

如果你是在终端里执行./gradlew，可以通过以下方式确保Gradle继承完整PATH：

• 把PATH的配置移到~/.zprofile（zsh）或~/.bash_profile（bash）中，而不是~/.zshrc或~/.bashrc（登录shell会优先加载前者），然后重启终端再运行Gradle命令。
• 临时解决：先在终端执行source ~/.zprofile（对应你的shell配置文件），再运行./gradlew buildImage。

方法二：在Gradle任务中手动补充PATH #

适合团队项目，无需每个成员单独配置，直接在build.gradle的Exec任务中添加PATH配置：

task buildImage(type: Exec) {
    // 将/usr/local/bin添加到PATH最前面，确保优先找到Docker
    environment "PATH", ["/usr/local/bin", System.getenv("PATH")].join(":")
    
    executable 'docker'
    // 其他任务配置...
}

如果要避免重复添加路径，可以增加判断逻辑：

task buildImage(type: Exec) {
    def systemPath = System.getenv("PATH")
    def dockerPath = "/usr/local/bin"
    def newPath = systemPath.contains(dockerPath) ? systemPath : "${dockerPath}:${systemPath}"
    
    environment "PATH", newPath
    executable 'docker'
    // 其他任务配置...
}

方法三：全局配置Gradle环境变量 #

适合个人本地使用，创建或修改~/.gradle/gradle.properties文件，添加PATH配置：

org.gradle.environment.PATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

注意：这个配置是全局生效的，团队成员需要各自手动配置，不适合团队项目统一使用。

方法四：IDE中运行的配置调整 #

如果是在IntelliJ等IDE中运行Gradle任务：

1. 打开「运行/调试配置」，找到对应的Gradle任务。
2. 在「环境变量」栏中添加PATH=/usr/local/bin:$PATH。
3. 保存配置后重新运行任务即可。

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