Bun 2.0에서 모노레포 workspaces가 동작 안 합니다 (NestJS + Next.js)

Question

Bun 2.0 모노레포에서 워크스페이스 의존성이 해석 안 되는 문제. catalog protocol과 PostInstall 설정 점검.

김영삼 · Accepted Answer

Bun 2.0은 npm/pnpm와 workspace 동작이 미묘하게 다릅니다. 4가지를 체크하세요.
1) 워크스페이스 패키지의 package.json 확인
// packages/ui/package.json
{
  "name": "@scope/ui",
  "version": "0.0.0",
  "main": "./src/index.ts",        // ← 빌드 안 한다면 .ts 그대로
  "types": "./src/index.ts",
  "exports": {
    ".": {
      "bun": "./src/index.ts",     // Bun 우선
      "import": "./dist/index.js",
      "types": "./src/index.ts"
    }
  }
}
Bun은 main보다 exports를 우선 봅니다. exports 필드 누락이 가장 흔한 원인.
2) 의존성 명시
// apps/web/package.json
{
  "dependen

풀스택지훈 · Answer

저도 비슷한 이슈 겪었는데 한 가지만 더 추가하면 — Bun 2.0의 catalog 프로토콜을 같이 쓰면 의존성 버전 통일이 훨씬 쉬워져요.
// 루트 package.json
{
  "workspaces": {
    "packages": ["apps/*", "packages/*"],
    "catalog": {
      "react": "^19.2.0",
      "typescript": "^6.0.0"
    }
  }
}

// apps/web/package.json
{
  "dependencies": {
    "react": "catalog:",
    "@scope/ui": "workspace:*"
  }
}
모든 워크스페이스가 같은 React 버전을 쓰게 강제됩니다. 듀얼 React 인스턴스 문제 자동 방지.

모노레포러버 · Answer

exports 필드 빼먹은 게 원인이었습니다. 추가하니 바로 인식됐어요. catalog 프로토콜도 처음 알았는데 도입해보겠습니다. 두 분 다 감사합니다!

댓글 0