Docker Compose配置PHP8.1+Node16+Webpack时npm未找到问题

算力阿峰

2026-8-26

问题根因

一共三个核心配置错误，直接导致你遇到的所有异常：

路径拼写错误导致webpack服务实际用了PHP镜像构建：你在docker-compose.yml中声明webpack服务的Dockerfile路径为config/docker/services/webpack/Dockerfile，但你实际存放该Dockerfile的路径为config/docker/service/webpack/Dockerfile（路径中services少写了末尾的s）。Docker Compose在build阶段找不到指定Dockerfile时，会默认读取构建上下文根目录的Dockerfile——也就是你用来构建PHP服务的那个Dockerfile。最终你所谓的webpack服务镜像本质是PHP+Apache镜像，内部根本没有npm，执行npm命令自然报not found，执行sh进入的也是PHP容器环境。这也解释了为什么build阶段没有COPY报错：根目录的PHP Dockerfile本身的COPY逻辑是正常的。
webpack的Dockerfile配置缺失：没有指定工作目录，直接把文件COPY到/home/node/app路径时，该路径默认不存在，多文件COPY会把目标路径识别为文件而非目录，最终文件复制逻辑完全失效；同时没有切换到代码目录就执行npm命令，就算npm存在也会找不到package.json。
冗余配置导致镜像标签混乱：你在webpack服务配置中同时写了image: node:16和自定义build规则，会让Compose把构建出来的错误镜像（PHP镜像）打上node:16的标签，污染本地镜像缓存，加重异常表现。
额外逻辑问题：你把npm install写到CMD启动命令里，会导致每次容器重启都重新安装依赖，启动速度慢且稳定性差。

你测试新增的redis服务能正常进入，是因为redis服务直接使用公共镜像，没有自定义build逻辑，不会触发上述路径错误。

修复方案

按以下步骤逐一修正配置即可：

修正docker-compose.yml配置
删除webpack服务下冗余的image: node:16配置，确认Dockerfile路径和磁盘实际存放路径完全统一，新增卷挂载保证webpack watch模式能检测到本地文件变化，添加tty配置避免容器意外退出。修正后配置参考：

version: "3.9"
services:
  web:
    build:
      context: .
    extra_hosts:
      - "docker.local:host-gateway"
    ports:
      - "8000:80"
    volumes:
      - .:/var/www/html
  webpack:
    build:
      context: .
      # 请确认此处路径和你磁盘上的webpack Dockerfile存放路径完全一致，注意services的复数拼写
      dockerfile: config/docker/services/webpack/Dockerfile
    volumes:
      - .:/home/node/app
    tty: true
    depends_on:
      - web

修正webpack服务的Dockerfile
提前声明工作目录，配置对应权限，把依赖安装步骤放到镜像构建阶段提升启动速度，修正启动命令。修正后内容参考：

FROM node:16-alpine

# 声明工作目录，路径不存在时Docker会自动创建
WORKDIR /home/node/app
# 给node镜像内置的非root用户分配工作目录操作权限
RUN chown -R node:node /home/node/app
USER node

# 先复制依赖描述文件，充分利用Docker构建缓存，后续业务代码变更不需要重新安装npm依赖
COPY --chown=node:node package*.json ./
RUN npm install

# 复制webpack配置文件
COPY --chown=node:node webpack.config.js ./

# 容器启动后直接执行watch模式，不需要重复执行npm install
CMD ["node_modules/.bin/webpack", "--watch"]

清理错误缓存后重新启动
之前错误构建的镜像和缓存会影响新配置生效，执行以下命令清理后重新构建：

# 停止现有容器，删除关联卷和本地构建的错误镜像
docker compose down -v --rmi local
# 无缓存重新构建所有镜像
docker compose build --no-cache
# 后台启动服务
docker compose up -d

验证方法

启动后执行docker compose logs webpack，如果没有npm相关报错，能看到webpack编译输出即为正常；执行docker compose exec webpack sh可正常进入node容器环境，执行npm -v可输出版本号。

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