Next.js配置报错：将next.config.ts改为js后仍出错该怎么办？

• 先核对next.config.js的语法规范：

  • 彻底删掉原TS文件里的类型相关代码，比如import type { NextConfig } from 'next'这类语句必须移除，JS文件不需要类型声明。
  • 导出配置的方式要符合JS规范：如果用CommonJS就写module.exports = nextConfig；如果用ES模块，要么把文件名改成next.config.mjs，要么在项目根目录的package.json里加上"type": "module"，再用export default nextConfig。

• 清理缓存后重新构建：

  • 删掉.next缓存目录和node_modules，执行命令：

    # macOS/Linux
    rm -rf .next node_modules
    # Windows
    rd /s /q .next node_modules
    

  • 重新安装依赖：npm install（或yarn install），再运行构建命令npm run build。

• 检查Next.js版本兼容性：

  • 打开package.json看next的版本号，部分旧版本不支持新的配置项。如果是版本过低，直接升级到稳定版：npm install next@latest。

• 针对具体错误针对性解决：

  • 把新出现的完整错误信息列出来，比如如果是ReferenceError: module is not defined，就是ES模块和CommonJS混用的问题；如果是某个配置项报错，大概率是配置拼写错误或者版本不支持，比如experimental.appDir在旧版本里不存在。

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