Docker构建Next.js多工作区前端镜像时next模块缺失求助

我在构建包含Turborepo工作区的Next.js项目Docker镜像时，执行docker build -t nextjs:v1 -f Dockerfile.prod .报错，提示找不到/app/apps/assigneePortal/node_modules/next/dist/bin/next模块。

我的Dockerfile.prod内容：

FROM node:18-alpine

WORKDIR /app

RUN npm i -g pnpm

COPY package.json pnpm-lock.yaml ./

COPY apps/assigneePortal/package.json apps/assigneePortal/.env.local ./apps/assigneePortal/
COPY packages/IriseV3_front-core/package.json ./packages/IriseV3_front-core/
COPY packages/config-tailwind/package.json ./packages/config-tailwind/
COPY packages/config-typescript/package.json ./packages/config-typescript/

RUN pnpm install

COPY . .

RUN corepack enable pnpm && pnpm run build

报错核心片段：

assigneeportal:build: Error: Cannot find module '/app/apps/assigneePortal/node_modules/next/dist/bin/next'
assigneeportal:build:     at Module._resolveFilename (node:internal/modules/cjs/loader:1140:15)
assigneeportal:build:     at Module._load (node:internal/modules/cjs/loader:981:27)
...
ERROR: failed to solve: process "/bin/sh -c corepack enable pnpm && pnpm run build" did not complete successfully: exit code: 1

错误原因 #

1. 依赖被覆盖：COPY . .会复制本地所有文件到容器，如果本地node_modules没被.dockerignore排除，会直接覆盖容器中pnpm安装好的依赖结构，导致Next.js模块丢失。
2. pnpm版本冲突：先全局安装pnpm，再用corepack enable pnpm切换版本，导致依赖安装和构建用的pnpm版本不匹配，破坏了pnpm的虚拟依赖链接。
3. 工作区依赖解析不全：手动逐个复制子项目package.json的方式，可能没让pnpm正确识别工作区内部依赖关联，导致Next.js未被纳入子项目依赖链。

解决方案 #

1. 重构Dockerfile优化构建流程 #

修改Dockerfile，确保依赖安装后不被覆盖，统一pnpm版本管理：

FROM node:18-alpine

WORKDIR /app

# 用corepack统一管理pnpm版本，避免版本冲突
RUN corepack enable && corepack prepare pnpm@latest --activate

# 先复制工作区核心配置文件
COPY pnpm-workspace.yaml package.json pnpm-lock.yaml ./

# 批量复制所有工作区的package.json（简化写法）
COPY apps/assigneePortal/package.json apps/assigneePortal/.env.local ./apps/assigneePortal/
COPY packages/*/package.json ./packages/

# 冻结锁文件安装依赖，确保和本地依赖完全一致
RUN pnpm install --frozen-lockfile

# 复制项目源码（需确保.dockerignore排除本地依赖和构建产物）
COPY . .

# 执行构建
RUN pnpm run build

2. 完善.dockerignore配置 #

确保本地依赖和构建产物不会被复制到容器，添加以下内容到.dockerignore：

node_modules
.next
pnpm-lock.yaml.local
.env.local
.DS_Store
.git
.gitignore

3. 验证pnpm工作区配置 #

检查项目根目录pnpm-workspace.yaml是否正确包含所有工作区：

packages:
  - 'apps/*'
  - 'packages/*'

4. 对齐本地与容器的pnpm版本 #

查看本地pnpm版本：pnpm --version，然后在Dockerfile中指定对应版本，比如本地是9.1.4，就改成：

RUN corepack prepare pnpm@9.1.4 --activate

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