创建Node+Electron Docker容器启动失败：webpack未找到报错排查

问题根源 #

1. 本地目录挂载覆盖容器内node_modules：docker-compose中- .:/home/app将本地目录完全覆盖容器内的/home/app，导致容器构建时安装的webpack等依赖被本地未安装对应依赖的node_modules替换。
2. Dockerfile存在错误指令：
   • 重复的CMD指令，最后一个会覆盖前面的，冗余指令无效。
   • RUN npm install install是错误命令，应为RUN npm install。
3. 局部依赖执行路径问题：webpack是局部安装的，直接调用webpack无法找到，需通过npx或package.json脚本执行。

具体修复步骤 #

1. 修正Dockerfile #

FROM node:19-bullseye

RUN apt-get update && apt-get install \
    git libx11-xcb1 libxcb-dri3-0 libxtst6 libnss3 libatk-bridge2.0-0 libgtk-3-0 libxss1 libasound2 \
    -yq --no-install-suggests --no-install-recommends \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

RUN mkdir -p /home/app/ && chown -R node:node /home/app/

WORKDIR /home/app/
USER node

COPY . /home/app/

# 修正错误的install命令，安装全部项目依赖
RUN npm install
# 单独安装指定开发依赖（可选，npm install已会自动安装devDependencies）
RUN npm install --save-dev webpack webpack-cli webpack-dev-server electron
RUN npx electron-rebuild

USER root

RUN chown root /home/app/node_modules/electron/dist/chrome-sandbox
RUN chmod 4755 /home/app/node_modules/electron/dist/chrome-sandbox

USER node
EXPOSE 6665

# 保留正确的启动命令，配合package.json脚本执行
CMD ["npm", "start"]

2. 调整docker-compose配置，避免覆盖node_modules #

修改volumes配置，只挂载必要的代码目录，同时用匿名卷保护容器内的node_modules：

version: "3"
services:
    service:
        build: .
        ports:
            - '6665:6665'
        container_name: serviceDesktop
        volumes:
            # 挂载本地核心代码目录，不覆盖容器内的node_modules
            - ./src:/home/app/src
            - ./build:/home/app/build
            - ./package.json:/home/app/package.json
            # 用匿名卷保留容器构建时安装的依赖
            - /home/app/node_modules

3. 确保package.json的start脚本正确 #

检查项目根目录的package.json，确保scripts中的start脚本包含完整的启动命令：

"scripts": {
  "start": "webpack serve --mode development --progress --config build/webpack.dev.conf.js electron"
}

4. 重新构建并启动容器 #

# 重新构建镜像
docker-compose build
# 启动容器
docker-compose up

额外说明 #

• 如果必须挂载整个本地目录，需确保本地先执行npm install安装所有依赖，但这种方式会破坏容器环境一致性的优势。
• 局部安装的依赖可通过npx webpack直接调用，或在package.json脚本中配置，避免全局安装带来的版本冲突问题。

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