Next.js中如何排除特定包打包？配置serverExternalPackages报错

可能的原因及对应方案 #

1. Next.js版本不兼容 #

serverExternalPackages是Next.js v13.4.13及以后才推出的稳定配置项，若使用的版本低于该版本，该配置项不会被识别。

• 检查当前版本：执行命令查看Next.js版本：

  npm list next
  # yarn用户执行：
  yarn list next
  

• 旧版本替代配置：若版本低于v13.4.13，改用实验性配置项：

  /** @type {import('next').NextConfig} */
  const nextConfig = {
    experimental: {
      serverComponentsExternalPackages: ['package-name'],
    },
  }
  
  // .mjs文件用ES模块导出
  export default nextConfig
  // .js文件用CommonJS导出
  // module.exports = nextConfig
  

2. 配置文件导出格式错误 #

报错提示为next.config.mjs文件，但原代码使用了CommonJS的module.exports导出方式，不符合ES模块文件（.mjs）的规范，可能导致配置识别异常。
修正导出方式：将.mjs文件的导出改为ES模块格式：

/** @type {import('next').NextConfig} */
const nextConfig = {
  serverExternalPackages: ['package-name'],
}

export default nextConfig

3. 缓存问题 #

若以上方案尝试后仍报错，清理Next.js缓存再重新构建：

npx next clean
npm run build

内容的提问来源于stack exchange，提问作者Luillyfe