部署Next.js应用时遇到next export命令废弃报错

问题原因 #

Next.js 13.4+版本已移除next export命令，改为通过在next.config.js中配置output: 'export'实现静态HTML导出，继续执行旧命令会触发报错。

解决步骤 #

1. 修改next.config.js配置 #

打开项目根目录的next.config.js文件，添加output: 'export'配置项：

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'export',
  // 保留你原有的其他配置，比如部署GitHub Pages所需的basePath等
}

module.exports = nextConfig

2. 更新导出命令 #

• 本地环境：无需再执行npx --no-install next export，直接运行next build（或对应包管理器命令npm run build/yarn build），构建完成后会自动生成out目录，里面就是静态导出的文件。
• GitHub Pages部署脚本：将原步骤中的npx --no-install next export替换为npx --no-install next build。

3. 验证配置有效性 #

• 执行构建命令后，检查项目根目录是否生成out文件夹。
• 可通过静态服务器本地验证：运行npx serve out，访问本地地址确认应用正常运行。

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