基于Yarn Berry+Nx的单体仓库Docker配置问题求助

环境背景 #

• 使用Yarn Berry实现零安装
• Nx管理Monorepo，目录结构如下：

packages
|-- A
|  |-- package.json (name: @mono/A)
|-- B // 依赖@mono/A
|  |-- package.json (name: @mono/B)
services
|-- C // 依赖@mono/B，基于Next.js
|  |-- package.json (name: @mono/C)
docker-compose.yml
package.json
nx.json

报错信息 #

构建B服务时出现依赖找不到的错误：

0.331 [1/4] Resolving packages...
1.112 info If you think this is a bug, please open a bug report with the information provided in "/packages/theme/yarn-error.log".
1.112 error An unexpected error occurred: "https://registry.yarnpkg.com/@mono%2fA: Not found".

问题根源 #

1. 构建上下文错误：当前docker-compose中B的构建上下文是./packages/B，Yarn无法访问根目录的workspace配置和packages/A的代码，导致workspace:^指向的@mono/A被当成公共包去npm registry查找，自然找不到。
2. Dockerfile语法错误：B的Dockerfile存在路径拼写错误（/packages/theme写成/packages/them）、未定义dep构建阶段，且没有复制整个monorepo的必要文件。
3. 服务依赖逻辑错误：docker-compose中C服务的depends_on指向了自身，属于无效配置。

正确配置方案 #

1. 调整docker-compose.yml配置 #

将所有服务的构建上下文改为根目录，通过指定dockerfile路径定位各模块的构建文件，同时修正C服务的依赖和路径错误：

version: "3"
services:
  A:
    build:
      dockerfile: ./packages/A/Dockerfile
      context: ./
    image: @mono/A:latest

  B:
    build:
      dockerfile: ./packages/B/Dockerfile
      context: ./
    depends_on:
      - A
    image: @mono/B:latest

  C:
    build:
      dockerfile: ./services/C/Dockerfile.dev
      context: ./
    image: @mono/C:latest
    volumes:
      - /app/services/C/node_modules
      - ./services/C:/app/services/C
    stdin_open: true
    ports:
      - "3000:3000"
    depends_on:
      - B

2. 修正A的Dockerfile #

确保复制根目录的Yarn配置文件，让Yarn能识别workspace：

FROM node:18-alpine AS base

# 设置工作目录为monorepo根目录
WORKDIR /app
# 复制根目录的Yarn配置和package.json
COPY package.json yarn.lock .yarnrc.yml ./
COPY .yarn ./.yarn

# 切换到A模块目录
WORKDIR /app/packages/A
COPY packages/A/package.json ./

# 安装依赖（Yarn会自动解析workspace依赖）
RUN yarn install --immutable

# 复制A模块的代码
COPY packages/A .

# 可选：构建A模块（如果需要产出编译后的文件）
RUN yarn build

3. 修正B的Dockerfile #

修复拼写错误，正确处理workspace依赖：

FROM node:18-alpine AS base

# 先在根目录处理workspace依赖
WORKDIR /app
COPY package.json yarn.lock .yarnrc.yml ./
COPY .yarn ./.yarn

# 切换到B模块目录
WORKDIR /app/packages/B
COPY packages/B/package.json ./

# 安装依赖（此时Yarn可以找到@mono/A的workspace依赖）
RUN yarn install --immutable

# 复制B模块的代码
COPY packages/B .

# 构建阶段
FROM base AS runner
WORKDIR /app/packages/B
# 执行构建命令
CMD ["yarn", "build"]

4. 关键说明 #

• 使用根目录作为构建上下文：让Yarn读取根目录的workspace配置，正确解析workspace:^类型的本地依赖，避免去公共registry查找。
• 保留Yarn Berry配置：复制.yarn目录和.yarnrc.yml文件，维持零安装特性，避免重复安装依赖。
• 利用Docker缓存：将依赖安装与代码复制步骤分离，提升后续构建速度。

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