如何修复构建Vue应用Docker镜像时出现的'stream terminated by RST_STREAM'错误

可行的解决步骤 #

1. 重启Docker服务（而非整机） #

Docker守护进程异常常引发这类内部错误，重启服务即可修复：

• Windows（PowerShell）：

  Restart-Service Docker
  

• Linux：

  sudo systemctl restart docker
  

• macOS：打开Docker Desktop，点击右上角菜单选择 Restart

2. 清理Docker缓存与冗余资源 #

构建缓存或临时资源损坏可能触发该错误，执行命令清理：

docker system prune -a

注意：此命令会删除未使用的镜像、容器、卷和网络，执行前确认无需保留这些资源。

3. 更换Node基础镜像版本 #

node:latest标签对应版本不稳定且体积大，易出现拉取故障，改用指定稳定版的轻量镜像：
修改Dockerfile为：

FROM node:20-alpine

WORKDIR /app

# 先复制依赖配置文件，利用Docker构建缓存
COPY package*.json ./
RUN npm install

# 再复制项目其余文件
COPY . .

CMD ["npm", "run", "dev"]

4. 完善.dockerignore配置 #

确保屏蔽不必要的文件，避免构建上下文过大或引入冲突文件，示例内容：

node_modules
dist
.git
.gitignore
.env
.DS_Store
.vscode

5. 检查网络连接与镜像拉取 #

先测试基础镜像能否正常拉取，确认网络无问题：

docker pull node:20-alpine

如果拉取失败，需检查网络环境，或配置Docker镜像加速源。

6. 重置Docker Desktop（仅适用于桌面版） #

若使用Docker Desktop，尝试重置到工厂默认设置：

1. 打开Docker Desktop的Settings
2. 进入Troubleshoot页面
3. 点击Reset to factory defaults

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