Docker部署Laravel+Vue3项目时前端容器启动失败求助

1. 隔绝宿主机依赖污染 #

如果你的docker-compose.yml里挂载了宿主机的node_modules目录，立刻移除这个挂载，改用容器内的匿名卷存储依赖——Windows下生成的依赖文件和Linux容器不兼容，会直接导致依赖缺失：

# docker-compose.yml 前端服务配置示例
services:
  frontend:
    image: node:16-bullseye
    working_dir: /app
    volumes:
      - ./frontend:/app
      - /app/node_modules  # 匿名卷，彻底隔离宿主机依赖
    command: sh -c "rm -rf node_modules package-lock.json && npm install && npm run dev"

2. 用npm ci替代npm install #

npm ci会严格按照package-lock.json安装依赖，且不会缓存可选依赖的错误，更适配容器环境：

# 替换容器启动命令为
rm -rf node_modules package-lock.json && npm install && npm ci && npm run dev

也可以直接在Dockerfile里预安装依赖，避免每次启动都重复操作：

# 前端Dockerfile示例
FROM node:16-bullseye
WORKDIR /app
COPY package*.json ./
RUN rm -rf node_modules package-lock.json && npm install
COPY . .
CMD ["npm", "run", "dev"]

3. 手动安装对应平台的Rollup包 #

直接在容器内安装Linux x64版本的Rollup依赖，强制匹配容器环境：

npm install @rollup/rollup-linux-x64-gnu --save-dev

4. 升级容器内的npm版本 #

该问题在npm 8.19+版本中已修复，升级后再重新安装依赖：

npm install -g npm@latest
rm -rf node_modules package-lock.json
npm install

5. 锁定Rollup与Vite的兼容版本 #

检查package.json，确保Vite和Rollup版本匹配，避免版本不兼容导致的依赖拉取错误：

{
  "devDependencies": {
    "rollup": "^2.79.1",
    "vite": "^3.2.7"
  }
}

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