serverExternalPackages

서버 컴포넌트와 라우트 핸들러 내에서 사용되는 의존성은 Next.js에 의해 자동으로 번들링됩니다.

만약 의존성이 Node.js 특정 기능을 사용하고 있다면, 해당 의존성을 서버 컴포넌트 번들링에서 제외하고 네이티브 Node.js require를 사용하도록 선택할 수 있습니다.

/** @type {import('next').NextConfig} */
const nextConfig = {
  serverExternalPackages: ["@acme/ui"],
};
 
module.exports = nextConfig;

Next.js는 현재 호환성 작업 중이며 자동으로 제외되는 인기 있는 패키지의 짧은 목록을 포함하고 있습니다:

• @appsignal/nodejs
• @aws-sdk/client-s3
• @aws-sdk/s3-presigned-post
• @blockfrost/blockfrost-js
• @highlight-run/node
• @jpg-store/lucid-cardano
• @libsql/client
• @mikro-orm/core
• @mikro-orm/knex
• @node-rs/argon2
• @node-rs/bcrypt
• @prisma/client
• @react-pdf/renderer
• @sentry/profiling-node
• @swc/core
• argon2
• autoprefixer
• aws-crt
• bcrypt
• better-sqlite3
• canvas
• cpu-features
• cypress
• dd-trace
• eslint
• express
• firebase-admin
• isolated-vm
• jest
• jsdom
• keyv
• libsql
• mdx-bundler
• mongodb
• mongoose
• next-mdx-remote
• next-seo
• node-cron
• node-pty
• node-web-audio-api
• oslo
• pg
• playwright
• playwright-core
• postcss
• prettier
• prisma
• puppeteer-core
• puppeteer
• rimraf
• sharp
• shiki
• sqlite3
• ts-node
• ts-morph
• typescript
• vscode-oniguruma
• webpack
• websocket
• zeromq