Laravel项目Docker部署：如何阻止非空主机目录覆盖容器挂载目录

你遇到的核心问题是主机目录挂载覆盖了容器构建阶段生成的内容：Dockerfile中在/usr/src下生成的node_modules和编译产物，被docker-compose里挂载的./:/var/www覆盖，导致容器启动后这些文件丢失。以下是针对不同场景的最佳解决方案：

方案一：生产环境 - 多阶段构建（推荐） #

将静态资源编译和PHP应用运行分离，最终只把编译好的产物打包到PHP镜像中，无需携带Node环境，镜像体积更小且更安全。

修改Dockerfile为多阶段构建：

# 第一阶段：编译静态资源
FROM node:16-alpine as asset-builder

WORKDIR /usr/src/app

# 先复制依赖配置文件，利用Docker缓存加速构建
COPY package.json package-lock.json vite.config.js ./
RUN npm install --global cross-env
RUN npm install

# 复制资源文件并编译
COPY ./resources ./resources
RUN npm run build

# 第二阶段：PHP应用镜像（替换为你实际使用的PHP基础镜像）
FROM php:8.1-fpm-alpine

WORKDIR /var/www

# 从编译阶段复制产物到PHP镜像的对应目录
COPY --from=asset-builder /usr/src/app/public/build /var/www/public/build

# 复制Laravel项目的其他文件
COPY . .

此时docker-compose无需单独配置node服务，直接运行PHP服务即可，编译好的静态资源已经包含在最终镜像里。

方案二：开发环境 - 匿名卷保留容器内文件 #

开发时需要实时同步主机代码修改，同时保留容器内的node_modules和编译产物，可通过匿名卷避免挂载覆盖：

1. 调整Dockerfile的工作目录，与docker-compose保持一致：

FROM node:16-alpine as node

WORKDIR /var/www

ADD ./resources ./resources
COPY ["package.json", "package-lock.json", "vite.config.js", "./"]

RUN npm install --global cross-env
RUN npm install
RUN npm run build

2. 修改docker-compose配置，添加匿名卷保护关键目录：

node:
  build:
    context: ./
    dockerfile: ./services/nodejs/Dockerfile
  working_dir: /var/www
  container_name: "nodejs"
  volumes:
    - ./:/var/www
    # 匿名卷：让容器内的node_modules不受主机挂载覆盖
    - /var/www/node_modules
    # 匿名卷：保留编译后的静态资源目录
    - /var/www/public/build
  tty: true
  depends_on:
    - php

这样主机代码修改会同步到容器，但node_modules和public/build会保留容器构建时的内容，同时你可以在容器内执行npm run dev实现热更新。

方案三：临时构建场景 - 一次性容器执行命令 #

如果不需要长期运行node服务，仅需偶尔编译资源，可直接用临时容器执行构建，产物直接输出到主机目录：

docker run --rm -v $(pwd):/var/www -w /var/www node:16-alpine sh -c "npm install --global cross-env && npm install && npm run build"

此方法适合CI/CD流程或本地快速构建，无需维护长期运行的容器。

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