Yarn Workspaces Monorepo构建单模块Docker时锁文件报错求助

前置清理：移除子模块冗余锁文件 #

Monorepo使用Yarn Workspaces时，子模块（moduleA/moduleB）下的yarn.lock属于冗余文件，会干扰根目录锁文件的统一管理。先删除所有子模块内的yarn.lock，后续所有依赖管理仅通过根目录的yarn.lock进行。

方案1：使用Yarn --focus 参数（Yarn 2+ 适用） #

该参数会让Yarn仅安装指定工作区的依赖，同时严格遵循根锁文件的内容，不会触发锁文件修改的报错。

以moduleA的Dockerfile为例：

# 基础镜像
FROM node:18-alpine

# 设置工作目录
WORKDIR /app

# 复制根目录的依赖配置和锁文件
COPY package.json yarn.lock ./

# 创建moduleA目录并复制其package.json
RUN mkdir -p moduleA
COPY moduleA/package.json ./moduleA/

# 仅安装moduleA的依赖，保持锁文件不可变
RUN yarn install --focus --production

# 复制moduleA的业务代码
COPY moduleA/ ./moduleA/

# 启动命令（根据实际情况调整）
CMD ["node", "./moduleA/index.js"]

方案2：Docker多阶段构建（兼容Yarn 1.x/2+） #

通过多阶段构建，先在包含完整Monorepo结构的环境中完成依赖安装，再将单个模块的代码和所需依赖复制到最终镜像，彻底规避锁文件不匹配问题。

# 第一阶段：完整安装所有依赖
FROM node:18-alpine AS builder

WORKDIR /app

# 复制整个Monorepo的文件
COPY . .

# 安装所有依赖（若仅需生产依赖可加--production）
RUN yarn install

# 第二阶段：构建最终运行镜像
FROM node:18-alpine

WORKDIR /app

# 复制builder阶段的node_modules（统一依赖）
COPY --from=builder /app/node_modules ./node_modules

# 复制moduleA的代码和配置
COPY moduleA/ ./moduleA/
COPY package.json yarn.lock ./

# 启动命令
CMD ["node", "./moduleA/index.js"]

这种方式无需修改Yarn配置，同时能保证依赖版本与本地完全一致，适合需要保留开发依赖进行构建（如编译TS）的场景。

方案3：使用Yarn Workspaces的focus命令（Yarn 1.x 适用） #

Yarn 1.x没有--focus参数，但可以通过yarn workspaces focus命令实现类似效果：

在moduleA的Dockerfile中替换安装命令为：

RUN yarn workspaces focus moduleA --production

注意执行该命令前，需确保根目录和moduleA的package.json已被复制到镜像中。

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