如何解决Docker执行docker-compose up时出现的Windows命名管道错误109？

DevOps 小满

2026-8-18

Docker Windows命名管道错误（code:109）解决方法

以下是针对容器启动即停止并抛出ERROR: Windows named pipe error: The pipe has been ended. (code: 109)错误的常见修复方案：

重启Docker服务
打开任务管理器，找到「Docker Desktop」相关进程，结束后重新启动；也可以用管理员权限打开命令提示符，执行：
```
net stop docker
net start docker
```
检查WSL2后端状态
如果你使用WSL2作为Docker后端，先确认WSL是否正常运行：
```
wsl --list --verbose
```
若状态异常，执行wsl --shutdown关闭所有WSL实例，再重启Docker Desktop。
重置Docker Desktop至出厂设置
打开Docker Desktop的「设置」面板，进入「Troubleshoot」选项，点击「Reset to factory defaults」。注意：此操作会清除本地镜像、容器等数据，建议提前备份。
以管理员身份运行命令
尝试用管理员权限打开PowerShell或命令提示符，重新执行docker-compose up，避免权限不足导致的管道访问问题。
排查容器配置问题
容器启动后立即停止，可能是docker-compose.yml或Dockerfile中没有配置前台运行的命令。比如确保服务的启动命令能让容器保持运行，例如在Dockerfile中添加：
```
CMD ["tail", "-f", "/dev/null"]
```
或检查服务的command配置是否正确，避免执行完即退出的命令。