GitHub仓库缺少dist目录是否会引发Dockerfile构建报错？

问题 #

我正尝试通过GitHub上的副本在Render.com部署PeerJS Server。创建Web服务时Render.com会自动完成各项配置。我的GitHub根目录下的Dockerfile内容如下：

FROM node:alpine
RUN mkdir /peer-server
WORKDIR /peer-server
COPY bin ./bin
COPY dist ./dist
COPY package.json .
RUN npm install --production
EXPOSE 9000
ENTRYPOINT ["node", "bin/peerjs"]
CMD [ "--port", "9000", "--path", "/myapp" ]

但Render.com构建时出现如下报错日志：

Jan 14 03:27:36 PM  Dockerfile:5
Jan 14 03:27:36 PM  --------------------
Jan 14 03:27:36 PM     3 |     WORKDIR /peer-server
Jan 14 03:27:36 PM     4 |     COPY bin ./bin
Jan 14 03:27:36 PM     5 | >>> COPY dist ./dist
Jan 14 03:27:36 PM     6 |     COPY package.json .
Jan 14 03:27:36 PM     7 |     RUN npm install --production
Jan 14 03:27:36 PM  --------------------
Jan 14 03:27:36 PM  error: failed to solve: failed to compute cache key: failed to calculate checksum of ref k0xqk3go2ko8jkmhel1pr1ugp::u02fc82vzv7zvmwdwr4k6r805: "/dist": not found

我的GitHub仓库中并无dist目录，请问是否是修改项目后未同步更新Dockerfile导致的该问题？

解答 #

核心原因就是Dockerfile指定要复制dist目录，但你的GitHub仓库中不存在这个目录，可能有两种情况：

1. 你修改项目时删除了dist目录，但没有同步更新Dockerfile，导致构建时找不到要复制的文件。
2. 你直接复制了PeerJS Server源码仓库的内容，而源码仓库通常不会把dist（构建产物）提交到仓库（可查看.gitignore确认），但原项目的Dockerfile是针对已经构建完成的版本（比如发布到npm的包或预构建分支）编写的，所以直接用源码仓库的Dockerfile会报错。

解决方案 #

根据你的情况选择对应方案：

• 如果是自己修改项目导致dist被删除：
  要么在Dockerfile中删除COPY dist ./dist这一行（如果项目运行不再依赖dist目录），要么本地执行项目的构建命令生成dist后，将该目录推送到GitHub仓库。

• 如果是直接使用源码仓库部署：
  修改Dockerfile，加入构建步骤生成dist目录，示例如下：

  FROM node:alpine
  RUN mkdir /peer-server
  WORKDIR /peer-server
  COPY package.json .
  RUN npm install # 安装所有依赖（包括开发依赖，用于构建）
  COPY . .
  RUN npm run build # 执行项目构建命令，生成dist目录
  RUN npm prune --production # 清理开发依赖，减小镜像体积
  EXPOSE 9000
  ENTRYPOINT ["node", "bin/peerjs"]
  CMD [ "--port", "9000", "--path", "/myapp" ]
  

  注意：要确认项目的package.json中存在build脚本，若没有则替换为项目实际的构建命令。

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