본문 바로가기
Q&A해결2026년 4월 22일1분 읽기

Bun 2.0에서 prisma generate 후 타입 추론이 깨집니다

B
Bun러너
조회 690댓글 1

Bun 2.0으로 백엔드를 운영 중인데 bunx prisma generate 후 IDE에서 prisma.user.findMany의 반환 타입이 any로 인식됩니다.

실행은 정상적이고, 같은 코드가 Node.js + tsc 환경에서는 타입 추론이 잘 됩니다. tsconfig는 standard, "moduleResolution": "bundler"로 두고 있고요.

Bun 환경에서만 발생하는 이유와 해결법이 궁금합니다.

댓글 1

김김영삼7개월 전

Bun 2.0과 Prisma 6.x의 잘 알려진 호환 이슈입니다. 원인이 두 갈래라 하나씩 점검해야 합니다.

1) Prisma client 출력 위치

Prisma 6부터 기본 출력 경로가 node_modules/.prisma/client로 변경됐습니다. Bun은 일부 케이스에서 이 경로의 type declaration을 못 찾습니다.

해결 — schema.prisma에 명시적 output 지정:

generator client {
provider = "prisma-client-js"
output = "../node_modules/@prisma/client"
}

또는 새로 권장되는 모드:

generator client {
provider = "prisma-client" // 신형 generator (선택사항)
output = "./generated/prisma"
}

그리고 import 경로 변경:

// 신형 generator
import { PrismaClient } from './generated/prisma'

2) Bun의 자체 모듈 해석

Bun 2.0은 자체 resolver가 있는데 .prisma/client 처럼 점으로 시작하는 디렉토리를 일부 ts mode에서 무시합니다.

해결 — bunfig.toml에 명시:

[install]
exact = true

[install.lockfile]
saveTextLockfile = true

그리고 bun pm trust @prisma/client 한 번 실행 (postinstall script 활성화).

3) tsconfig 보강

{
"compilerOptions": {
"moduleResolution": "bundler",
"module": "ESNext",
"target": "ES2022",
"types": ["bun-types"],
"paths": {
"@prisma/client": ["./node_modules/@prisma/client"]
}
}
}

실무 체크리스트:

  1. bun --version 2.0.5 이상 권장 (이전 버전에 prisma 관련 버그 잔존)
  2. node_modules 삭제 후 bun install --force
  3. bunx prisma generate 직접 실행 (postinstall 의존하지 말기)
  4. IDE 재시작 (TypeScript 서버 재시작) — VS Code는 Cmd+Shift+P → "Restart TS Server"
  5. 여전히 안 되면 bun build --target=bun 으로 빌드 검증 — 빌드는 되는데 IDE만 못 잡는 케이스도 흔함

대안 — Prisma 신형 generator 'prisma-client'

Prisma 6.5부터 'prisma-client' generator가 안정 단계입니다. 이쪽은 처음부터 ESM·Bun을 1급 시민으로 다룹니다.

generator client {
provider = "prisma-client"
output = "./generated"
runtime = "bun"
importFileExtension = "ts"
}

새 프로젝트라면 신형으로 시작하는 게 가장 깔끔합니다. 운영 중인 프로젝트도 5월 안에 마이그레이션 권장 — 구형 generator는 6.x 후반에 deprecated 예정입니다.

Ctrl+Enter로 등록