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 = nextConfigNext.js 包含了一个常用包的简短列表,这些包目前正在进行兼容性工作,并已自动排除:
@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/transformersargon2autoprefixeraws-crtbcryptbetter-sqlite3canvaschromadb-default-embedconfigcpu-featurescypressdd-traceeslintexpressfirebase-adminhtmlrewriterimport-in-the-middleisolated-vmjestjsdomkeyvlibsqlmdx-bundlermongodbmongoosenewrelicnext-mdx-remotenext-seonode-cronnode-ptynode-web-audio-apionnxruntime-nodeoslopgplaywrightplaywright-corepostcssprettierprismapuppeteer-corepuppeteerravendbrequire-in-the-middlerimrafsharpshikisqlite3ts-nodets-morphtypescriptvscode-onigurumawebpackwebsocketzeromq
| Version | Changes |
|---|---|
v15.0.0 | 从实验性功能迁移至稳定版。从 serverComponentsExternalPackages 重命名为 serverExternalPackages |