Docker容器中本地gulp无法找到的问题排查与解决求助

我正在重构一个基于Django和gulp.js的旧项目，gulp用于构建Django的静态资源，目前正在对该项目进行Docker容器化。我使用了Docker Hub上的nikolaik/python-nodejs组合镜像，安装了Django和Node.js所需的依赖包，将src目录下的源码复制到容器的/usr/src/app目录后，运行gulp和./manage.py runserver命令，但执行gulp时出现如下错误：

app  | [06:49:46] Local gulp not found in /usr/src/app
app  | [06:49:46] Try running: yarn add gulp

项目目录结构如下：

.
└── project/
    ├── dockerfiles/
    │   └── app.Dockerfile
    ├── src/
    │   ├── apps/
    │   ├── entrypoints/
    │   │   └── entrypoint-local.sh
    │   ├── gulpfile.js
    │   ├── manage.py
    │   ├── package.json
    │   └── package-lock.json
    ├── .local.env
    └── docker-compose.yml

docker-compose配置：

version: "3.9"

services:
  app:
    container_name: app
    build:
      dockerfile: ./dockerfiles/app.Dockerfile
    entrypoint: ./entrypoints/entrypoint-local.sh
    volumes:
      - ./src:/usr/src/app
      - static:/static
    ports:
      - "8000:8000"
    env_file:
      - .local.env

容器构建的Dockerfile内容：

# syntax=docker/dockerfile:1
FROM nikolaik/python-nodejs:python3.7-nodejs19-bullseye

WORKDIR /usr/src/app

RUN apt-get update \
    && apt-get install -y binutils libproj-dev libgeos-dev gdal-bin libgeoip1 libgdal-dev gdal-bin \
    && apt-get install -y build-essential libssl-dev libffi-dev python3-dev python3-pip python3-venv \
    && rm -fr /var/lib/apt/lists

RUN pip install --upgrade pip
COPY /src/requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY /src/package*.json .
RUN npm install
RUN npm install -g gulp-cli
RUN npm install --save-dev gulp

COPY /src .

RUN chmod +x ./entrypoints --recursive

入口脚本entrypoint-local.sh内容：

#!/bin/sh

python manage.py migrate --no-input
gulp
python manage.py runserver

已在入口脚本中确认gulpfile.js存在，且移除gulp命令后Django可正常启动，请问为何会出现该错误，如何解决？

• Dockerfile中虽安装了本地gulp（npm install --save-dev gulp），但docker-compose配置了./src:/usr/src/app的卷挂载，容器启动时本地src目录会覆盖容器内/usr/src/app的内容，导致构建时安装的node_modules被替换。若本地src目录无node_modules或其中不含gulp，就会触发错误。
• 全局安装的gulp-cli仅作为调用入口，必须依赖项目本地安装的gulp包才能正常运行。

方案一：调整卷挂载策略（推荐） #

修改docker-compose.yml，避免直接挂载整个src目录覆盖容器内的node_modules，改为仅挂载需要实时同步的文件/目录：

volumes:
  - ./src/apps:/usr/src/app/apps
  - ./src/entrypoints:/usr/src/app/entrypoints
  - ./src/gulpfile.js:/usr/src/app/gulpfile.js
  - ./src/manage.py:/usr/src/app/manage.py
  # 按需添加其他需要实时修改的文件/目录
  - static:/static

此方案可保留容器构建时安装的node_modules，确保gulp能找到本地依赖。

方案二：在入口脚本中补装依赖 #

修改entrypoint-local.sh，在运行gulp前执行依赖安装：

#!/bin/sh

python manage.py migrate --no-input
# 确保本地gulp依赖存在
npm install
gulp
python manage.py runserver

该方案适合开发环境，缺点是容器启动时会重复安装依赖，启动速度较慢。

方案三：配合.dockerignore优化依赖管理 #

在本地src目录下创建.dockerignore文件，添加：

node_modules/

避免构建镜像时将本地node_modules复制到容器中，配合方案二的入口脚本，可确保容器内依赖环境干净无冲突。

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