spring-boot:build-image不识别自定义DOCKER_HOST路径求助

以下是几种可行的解决方式，按优先级尝试：

1. 显式传递环境变量给Maven Wrapper #

直接在执行构建命令时指定DOCKER_HOST，确保Maven Wrapper能获取到正确的变量值：

DOCKER_HOST=unix:///run/user/1000/docker.sock ./mvnw spring-boot:build-image

如果之前是临时设置的环境变量，建议先执行echo $DOCKER_HOST确认变量已生效，再执行构建命令。

2. 修正spring-boot-maven-plugin的配置 #

之前配置无效可能是节点路径错误，Cloud Native Buildpacks模式下（Spring Boot 2.4+默认），需将Docker主机配置放在<docker>子节点中：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <docker>
            <host>unix:///run/user/1000/docker.sock</host>
        </docker>
    </configuration>
</plugin>

注意：不要混淆旧版Docker插件的配置项，Cloud Native Buildpacks的配置逻辑不同。

3. 全局配置DOCKER_HOST环境变量 #

将DOCKER_HOST写入shell配置文件，确保每次启动终端都自动加载：

echo 'export DOCKER_HOST=unix:///run/user/1000/docker.sock' >> ~/.bashrc
source ~/.bashrc

之后再执行./mvnw spring-boot:build-image即可自动读取该变量。

4. 检查Docker Socket权限与服务状态 #

确认/run/user/1000/docker.sock的权限，确保当前用户拥有读写权限：

ls -l /run/user/1000/docker.sock

若权限不足，执行：

sudo chown $USER:$USER /run/user/1000/docker.sock

如果是rootless Docker模式，还需确保用户级Docker服务已启动：

systemctl --user start docker

内容的提问来源于stack exchange，提问作者D. Kellenberger