serverExternalPackages
让特定依赖退出 Server Components 打包,改用原生 Node.js require。
在 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 = nextConfigNext.js 包含一份热门软件包的简短列表,这些软件包目前正在进行兼容性适配,并已被自动选择退出打包:
@alinea/generated@appsignal/nodejs@aws-sdk/client-s3@aws-sdk/s3-presigned-post@blockfrost/blockfrost-js@highlight-run/node@huggingface/transformers@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@sparticuz/chromium@sparticuz/chromium-min@statsig/statsig-node-core@swc/core@xenova/transformers@zenstackhq/runtimeargon2autoprefixeraws-crtbcryptbetter-sqlite3canvaschromadb-default-embedconfigcpu-featurescypressdd-traceeslintexpressfirebase-adminhtmlrewriterimport-in-the-middleisolated-vmjestjsdomkeyvlibsqlmdx-bundlermongodbmongoosenewrelicnext-mdx-remotenext-seonode-cronnode-ptynode-web-audio-apionnxruntime-nodeoslopgpinopino-prettypino-rollplaywrightplaywright-corepostcssprettierprismapuppeteer-corepuppeteerravendbrequire-in-the-middlerimrafsharpshikisqlite3thread-streamts-morphts-nodetypescriptvscode-onigurumawebpackwebsocketzeromq
| Version | Changes |
|---|---|
v15.0.0 | 从 experimental 转为 stable。从 serverComponentsExternalPackages 重命名为 serverExternalPackages |