serverExternalPackages

Server Components 및 Route Handlers 내에서 사용되는 종속성은 Next.js에 의해 자동으로 번들됩니다.

종속성이 Node.js의 특정 기능을 사용하는 경우, 특정 종속성을 Server Components 번들링에서 제외하고 네이티브 Node.js require를 사용하도록 선택할 수 있습니다.

next.config.js

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

Next.js는 현재 호환성을 작업 중인 인기 패키지의 짧은 목록 (opens in a new tab)을 포함하며, 자동으로 제외됩니다:

Version	Changes
`v15.0.0`	실험적 기능에서 안정된 기능으로 전환되었습니다. `serverComponentsExternalPackages`에서 `serverExternalPackages`로 이름이 변경되었습니다.