GitLab CI/CD部署Node.js应用遇Redis模块缺失问题求助

核心问题分析 #

你遇到的「找不到Express/Redis模块」问题，本质是Docker镜像构建过程中没有正确安装package.json里的依赖，或者运行时容器内的node_modules被外部挂载覆盖。以下是针对性的解决方案：

1. 修复Dockerfile，确保依赖正确安装 #

这是最常见的根源：很多人会先复制全部代码再执行npm install，既浪费缓存，又可能因文件变动导致依赖安装异常。正确的写法应该先复制依赖配置文件，再安装依赖，最后复制应用代码：

# 使用官方Node.js镜像，推荐带alpine的轻量版本
FROM node:18-alpine

# 设置工作目录
WORKDIR /app

# 先复制package.json和package-lock.json，利用Docker缓存机制
# 只有当依赖配置变更时，才会重新执行npm install
COPY package*.json ./

# 使用npm ci替代npm install：严格按照package-lock.json安装依赖，避免版本不一致
# --only=production 只安装生产依赖，减小镜像体积
RUN npm ci --only=production

# 复制应用代码到容器内
COPY . .

# 可选：切换到非root用户运行，提升安全性
RUN chown -R node:node /app
USER node

# 暴露应用端口
EXPOSE 3000

# 启动应用
CMD ["node", "app.js"]

2. 检查GitLab CI流水线的镜像构建步骤 #

确保CI中正确执行镜像构建，且构建上下文包含所有必要文件：

示例gitlab-ci.yml片段 #

stages:
  - build
  - deploy

# 构建Docker镜像并推送到GitLab容器注册表
build-app-image:
  stage: build
  image: docker:latest
  services:
    - docker:dind  # 启用Docker-in-Docker
  variables:
    IMAGE_NAME: $CI_REGISTRY_IMAGE/app:$CI_COMMIT_SHA
  script:
    # 登录GitLab容器注册表
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    # 构建镜像
    - docker build -t $IMAGE_NAME .
    # 推送镜像到注册表
    - docker push $IMAGE_NAME

# 部署阶段：拉取镜像并启动容器
deploy:
  stage: deploy
  image: docker/compose:latest
  script:
    # 登录容器注册表
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    # 替换docker-compose.yml中的镜像标签
    - sed -i "s|APP_IMAGE_TAG|$CI_COMMIT_SHA|g" docker-compose.yml
    # 启动服务
    - docker-compose up -d

注意点：

• 不要在CI步骤中跳过docker build直接用本地代码挂载，必须通过镜像传递代码和依赖。
• 确保CI流水线的工作目录包含package.json和package-lock.json，检查.gitignore是否误排除了这两个文件。

3. 避免Docker Compose挂载覆盖node_modules #

如果你的docker-compose.yml中挂载了本地代码目录到容器，会直接覆盖容器内的/app目录，包括已安装的node_modules。解决方式分两种场景：

生产环境（推荐） #

完全不挂载本地目录，直接使用镜像内的代码和依赖：

version: '3.8'
services:
  app:
    image: $CI_REGISTRY_IMAGE/app:$CI_COMMIT_SHA
    ports:
      - "3000:3000"
    depends_on:
      - mariadb
      - redis
    environment:
      - NODE_ENV=production
  # 其他服务配置...

开发环境 #

挂载代码目录时，通过匿名卷保留容器内的node_modules：

version: '3.8'
services:
  app:
    build: .
    volumes:
      - ./:/app          # 挂载本地代码
      - /app/node_modules # 匿名卷，避免覆盖容器内的依赖
    ports:
      - "3000:3000"

4. 额外排查点 #

• 检查package.json中是否确实包含express和redis依赖，且没有拼写错误。
• 确认package-lock.json已提交到Git仓库，CI拉取代码时能获取到该文件。
• 如果使用私有npm源，需要在Dockerfile中添加npm config set registry配置，确保能拉取私有依赖。

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