Docker化Node.js应用时文件复制到WORKDIR报错如何修改Dockerfile

问题场景 #

尝试对使用Firebase cloud functions的Node.js应用做Docker化部署，本地项目目录结构如下：

非Docker环境下的启动流程：

1. 执行cd functions进入功能目录
2. 执行yarn serve启动服务，该脚本定义在functions/package.json中

初始编写的Dockerfile内容如下：

FROM node:14-alpine

WORKDIR /api

COPY package*.json ./

RUN npm install

COPY . ./api

CMD ["npm", "run", "serve"]

使用docker build -t <my-image-name> ../functions构建镜像后运行容器，服务启动失败，排查发现容器内文件结构和本地不一致。

错误原因 #

现有配置存在3个核心问题：

• 路径嵌套错误：WORKDIR /api已经指定容器内工作目录为/api，后续配置COPY . ./api会将构建上下文的文件全部复制到容器内/api/api路径下，导致工作目录根缺少package.json、业务代码等核心文件，启动脚本无法正常寻址。
• 包管理工具不匹配：本地通过yarn执行启动脚本，Dockerfile中使用npm执行命令，可能存在锁文件、脚本解析的兼容问题。
• 构建上下文与Dockerfile位置不匹配：若Dockerfile存放在项目根目录，指定../functions作为构建上下文时，文件复制路径极易出现错位。

修复方案 #

1. 将Dockerfile移动到本地functions目录下
2. 修改Dockerfile内容为以下配置：

FROM node:14-alpine

WORKDIR /api

# 优先复制依赖配置文件，利用Docker构建缓存减少重复安装
COPY package.json yarn.lock* package-lock.json* ./

# 全局安装yarn，和本地环境对齐安装依赖
RUN npm install -g yarn && yarn install --frozen-lockfile

# 复制所有业务文件到工作目录根，避免多余路径嵌套
COPY . .

# 对齐本地启动命令
CMD ["yarn", "serve"]

3. 调整构建命令：在项目根目录（functions目录的上级目录）执行构建

docker build -t <你的自定义镜像名> ./functions

4. 运行容器时映射服务对应监听端口即可。

补充说明：如果服务依赖项目根目录的firebase.json等配置文件，可以把Dockerfile移动到项目根目录，调整构建上下文为项目根，修改COPY逻辑按需复制functions目录和根目录配置文件即可。

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