Next.js启动报错：Cannot find module 'node:buffer' 求助

执行npm start或next start启动项目时，抛出如下错误：

Error: Cannot find module 'node:buffer'
Require stack:

• C:\Users\Acer\next-fcc-familyguy\node_modules\next\dist\server\web\sandbox\context.js
• C:\Users\Acer\next-fcc-familyguy\node_modules\next\dist\server\web\sandbox\sandbox.js
• C:\Users\Acer\next-fcc-familyguy\node_modules\next\dist\build\webpack\plugins\nextjs-require-cache-hot-reloader.js
• C:\Users\Acer\next-fcc-familyguy\node_modules\next\dist\server\lib\render-server.js
• C:\Users\Acer\next-fcc-familyguy\node_modules\next\dist\compiled\jest-worker\processChild.js

已尝试但未解决的步骤：

• 升级Node.js到v16+版本
• 删除node_modules和package-lock.json后重新执行npm install
• 执行npm update next升级Next.js
• 显式安装buffer包（npm install buffer）
• 检查package.json中的"type": "module"配置

以下是额外可行的解决方案：

1. 确认Node.js版本兼容性 #

部分Next.js版本（如13+）要求Node.js最低版本为16.8+，而非仅16+。执行node -v确认当前版本，若低于16.8，升级至16.8或更高稳定版（推荐18.x LTS版本）。

2. 强制清除Next.js缓存 #

Next.js的缓存可能导致模块解析异常，执行命令清除缓存：

npx next clean

清除完成后重新启动项目：npm start

3. 匹配Next.js与Node.js版本 #

若使用较新的Next.js版本（如13.4+），确保Node.js版本满足官方要求。若升级Node.js后问题依旧，可尝试降级Next.js到稳定兼容版本，例如：

npm install next@13.4.0

（选择与当前Node.js版本匹配的稳定版）

4. 配置webpack别名强制解析模块 #

在项目根目录创建或修改next.config.js，添加webpack别名配置，强制将node:buffer解析为内置模块：

/** @type {import('next').NextConfig} */
const nextConfig = {
  webpack: (config) => {
    config.resolve.alias['node:buffer'] = 'buffer';
    return config;
  },
};

module.exports = nextConfig;

保存配置后重新启动项目。

5. 解决全局与本地Node.js环境冲突 #

若存在全局Node.js版本与项目本地版本不一致的情况，使用nvm（Node版本管理器）统一版本：

• 安装nvm后，在项目目录创建.nvmrc文件，写入指定版本（如18.17.0）
• 执行nvm use切换到指定版本，再重新执行npm install和npm start

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