构建Docker镜像时copyfiles命令报错：退出码127求助

问题概述 #

基于Payload CMS电商模板构建前端应用Docker镜像时，执行copyfiles命令提示找不到，容器启动后立即退出（状态码127）。镜像可完成构建，但容器无法正常运行。

配置文件 #

Dockerfile（修改后） #

FROM node:18.8-alpine as base

WORKDIR /home/node/app
COPY package*.json ./

FROM base as builder
COPY . .
RUN yarn install

FROM base as runtime

ENV NODE_ENV=production
ENV PAYLOAD_CONFIG_PATH=dist/payload.config.js

WORKDIR /home/node/app
COPY package*.json  ./
COPY yarn.lock ./
RUN yarn install --production
COPY --from=builder /home/node/app/ .

EXPOSE 3000

CMD ["node", "dist/server.js"]

docker-compose.yml（修改后） #

version: '3'

services:
 frontend:
   build:
     context: .
   ports:
     - '3000:3000'
   volumes:
     - .:/home/node/app
     - node_modules:/home/node/app/node_modules
   working_dir: /home/node/app/
   command: sh -c "yarn install && yarn build && node dist/server.js"
   depends_on:
     - mongo
   env_file:
     - .env

 mongo:
   image: mongo:latest
   ports:
     - '27017:27017'
   command:
     - --storageEngine=wiredTiger
   volumes:
     - data:/data/db
   logging:
     driver: none

volumes:
 data:
 node_modules:

package.json 脚本片段 #

与Payload CMS电商模板一致：

"scripts": {
  "dev": "cross-env PAYLOAD_CONFIG_PATH=src/payload/payload.config.ts nodemon",
  "stripe:webhooks": "stripe listen --forward-to localhost:8000/stripe/webhooks",
  "seed": "rm -rf media && cross-env PAYLOAD_SEED=true PAYLOAD_DROP_DATABASE=true PAYLOAD_CONFIG_PATH=src/payload/payload.config.ts ts-node src/server.ts",
  "build:payload": "cross-env PAYLOAD_CONFIG_PATH=src/payload/payload.config.ts payload build",
  "build:server": "tsc --project tsconfig.server.json",
  "build:next": "cross-env PAYLOAD_CONFIG_PATH=dist/payload.config.js NEXT_BUILD=true node dist/server.js",
  "build": "cross-env NODE_ENV=production yarn build:payload && yarn build:server && yarn copyfiles && yarn build:next",
  "serve": "cross-env PAYLOAD_CONFIG_PATH=dist/payload.config.js NODE_ENV=production node dist/server.js",
  "eject": "yarn remove next react react-dom @next/eslint-plugin-next && ts-node eject.ts",
  "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,js}\" dist/",
  "generate:types": "cross-env PAYLOAD_CONFIG_PATH=src/payload/payload.config.ts payload generate:types",
  "generate:graphQLSchema": "PAYLOAD_CONFIG_PATH=src/payload/payload.config.ts payload generate:graphQLSchema",
  "lint": "eslint src",
  "lint:fix": "eslint --fix --ext .ts,.tsx src",
  "payload": "cross-env PAYLOAD_CONFIG_PATH=src/payload/payload.config.ts payload"
},

.env 关键配置 #

# 运行端口
PORT=3000
# 数据库连接字符串
DATABASE_URI=mongodb://mongo:27017/demo-application
# 其他配置…

错误日志 #

容器启动时输出错误：

yarn install v1.22.19
[1/4] Resolving packages...
success Already up-to-date.
Done in 0.35s.
yarn run v1.22.19
$ cross-env NODE_ENV=production yarn build:payload && yarn build:server && yarn copyfiles && yarn build:next
$ cross-env PAYLOAD_CONFIG_PATH=src/payload/payload.config.ts payload build
$ tsc --project tsconfig.server.json
$ copyfiles -u 1 "src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,js}" dist/
/bin/sh: copyfiles: not found
error Command failed with exit code 127.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
error Command failed with exit code 127.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

容器状态 #

CONTAINER ID   IMAGE                       COMMAND                  CREATED             STATUS                        PORTS                                           NAMES
e96c0357b5d7   demo-application-frontend   "docker-entrypoint.s…"   34 seconds ago      Exited (127) 14 seconds ago                                                   demo-application-frontend-1
a51909b3b5c5   mongo:latest                "docker-entrypoint.s…"   15 minutes ago      Up 14 minutes

问题分析 #

1. 依赖缺失原因：copyfiles属于开发依赖，Dockerfile的runtime阶段执行yarn install --production会跳过开发依赖安装。虽然builder阶段安装了全量依赖，但容器启动时挂载的本地node_modules卷可能覆盖了容器内的依赖，若本地环境未正确安装copyfiles，则容器内也无法找到该命令。
2. 重复构建冲突：docker-compose中自定义的command覆盖了Dockerfile的CMD，启动时重复执行构建流程，而本地目录挂载导致容器内文件与本地文件不一致，加剧依赖问题。

解决方案 #

方案1：构建阶段完成所有编译工作（推荐） #

修改Dockerfile，在builder阶段完成全部构建，runtime阶段仅复制产物，避免启动时重复操作：

FROM node:18.8-alpine as base

WORKDIR /home/node/app
COPY package*.json ./

FROM base as builder
COPY . .
RUN yarn install
RUN yarn build  # 在构建阶段完成所有编译步骤

FROM base as runtime

ENV NODE_ENV=production
ENV PAYLOAD_CONFIG_PATH=dist/payload.config.js

WORKDIR /home/node/app
COPY package*.json  ./
COPY yarn.lock ./
RUN yarn install --production
COPY --from=builder /home/node/app/dist ./dist  # 仅复制构建产物
COPY --from=builder /home/node/app/media ./media  # 复制静态资源目录

EXPOSE 3000

CMD ["node", "dist/server.js"]

同时修改docker-compose.yml，移除本地目录挂载和自定义启动命令：

services:
 frontend:
   build:
     context: .
   ports:
     - '3000:3000'
   depends_on:
     - mongo
   env_file:
     - .env

方案2：启动时安装全量依赖 #

若需保留本地目录挂载，修改docker-compose的启动命令，明确安装所有依赖：

command: sh -c "yarn install --production=false && yarn build && node dist/server.js"

方案3：全局安装copyfiles #

在Dockerfile的runtime阶段全局安装copyfiles：

FROM base as runtime

# 其他配置不变
RUN yarn install --production
RUN yarn global add copyfiles  # 全局安装copyfiles
COPY --from=builder /home/node/app/ .
# 其他配置不变

验证步骤 #

1. 清理现有容器与镜像：docker compose down -v && docker rmi demo-application-frontend
2. 重新构建并启动：docker compose up -d --build
3. 查看容器日志：docker logs demo-application-frontend-1，确认无错误输出
4. 检查容器状态：docker ps，确认容器处于运行状态

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