GitLab CI构建的Docker镜像npm依赖缺失问题求助

问题根源 #

本地构建时，项目目录下大概率已存在node_modules文件夹，执行COPY . /source/会把本地已安装的依赖一同复制到镜像中，因此容器启动后能正常运行。但GitLab CI构建环境是全新的，且node_modules通常会被加入.gitignore不会提交到仓库，导致CI构建时既没有依赖文件被复制到镜像，也没有在镜像内执行依赖安装步骤，最终出现live-server等依赖找不到的情况。

解决方案 #

1. 修改Dockerfile，添加依赖安装步骤 #

更新Dockerfile，在复制代码后执行npm install，确保镜像内部完成依赖安装：

FROM registry.dev.***/mpk/internal/node:20.10
MAINTAINER MPK Software <support@***>
ENV DEBIAN_FRONTEND=noninteractive

COPY . /source/
WORKDIR /source
# 安装项目所有依赖
RUN npm install

2. 添加.dockerignore文件（可选但推荐） #

在项目根目录创建.dockerignore文件，排除本地node_modules及其他无需复制到镜像的文件，避免本地依赖干扰镜像构建：

node_modules/
npm-debug.log
.git/

3. 验证CI构建逻辑 #

当前GitLab CI脚本使用--no-cache保证每次构建都是全新环境，这个设置是合理的，无需额外调整。

本地预验证方法 #

修改后可先在本地模拟CI的干净环境测试：

# 删除本地node_modules，模拟CI无依赖的状态
rm -rf node_modules
# 重新构建镜像
docker build -f docker/lh-front/Dockerfile .
# 运行容器测试npm start是否正常
docker run -it [镜像ID] npm start

如果本地测试正常，再推送至GitLab CI构建，拉取镜像后即可正常运行。

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