使用Maven插件构建Spring Boot Docker镜像时遇Broken pipe错误求助

我之前在使用Spotify的dockerfile-maven-plugin构建Spring Boot应用的Docker镜像时，也碰到过一模一样的"Broken pipe"错误，大概率是Docker客户端与服务端的连接异常，或者插件配置缺失关键参数导致的。下面是我总结的几个排查和解决步骤：

1. 先确认Docker服务是否正常运行 #

这是最基础的排查点，先在终端执行以下命令，验证能否正常连接Docker服务：

docker ps

如果命令返回连接失败类错误，说明Docker服务未启动或异常，先重启服务：

• Windows/macOS：打开Docker Desktop，点击重启按钮
• Linux：执行sudo systemctl restart docker

2. 补全Docker Maven插件的必要配置 #

你的插件配置只指定了执行阶段，但缺少镜像构建的核心配置项，这可能导致插件无法正确与Docker服务交互。给你一个完整的可参考配置，根据你的项目调整：

<plugins>
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
    </plugin>
    <plugin>
        <groupId>com.spotify</groupId>
        <artifactId>dockerfile-maven-plugin</artifactId>
        <version>1.3.6</version>
        <executions>
            <execution>
                <id>default</id>
                <phase>install</phase>
                <goals>
                    <!-- 明确指定要执行的构建目标，避免默认逻辑未触发build动作 -->
                    <goal>build</goal>
                </goals>
            </execution>
        </executions>
        <configuration>
            <!-- 指定Dockerfile路径，默认是项目根目录，若你的文件在其他位置需修改 -->
            <dockerfile>${project.basedir}/Dockerfile</dockerfile>
            <!-- 镜像名称，格式为 [仓库名/]<镜像名>:<标签> -->
            <repository>your-custom-image-name</repository>
            <tag>${project.version}</tag>
            <!-- 指定Docker服务连接地址，Linux下一般是unix:///var/run/docker.sock，Windows/macOS可保持默认 -->
            <dockerHost>unix:///var/run/docker.sock</dockerHost>
        </configuration>
    </plugin>
</plugins>

3. 检查Docker权限（Linux系统专属） #

Linux环境下，当前用户可能没有访问Docker socket的权限，导致连接失败。执行以下命令将当前用户加入docker组：

sudo usermod -aG docker $USER

执行后退出当前终端重新登录，再尝试构建操作。

4. 验证Docker客户端与服务端版本兼容性 #

Docker客户端和服务端版本差距过大也可能引发连接异常，执行docker version查看两者版本，尽量保证主版本一致，或差距不超过2个大版本。若版本差距过大，建议升级或降级到匹配版本。

5. 手动构建镜像排查问题 #

先跳过Maven插件，手动执行Docker构建命令，验证基础构建流程是否正常：

docker build -t test-image .

如果手动构建失败，说明问题出在Dockerfile或Docker环境本身；如果手动构建成功，再回到插件配置，检查是否遗漏参数或执行目标。

按照上面的步骤排查下来，应该能解决这个"Broken pipe"的问题。

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