执行npm run build时遇Webpack错误：UnhandledSchemeError求助

执行npm run build时触发的错误信息：

Module build failed: UnhandledSchemeError：读取"node:events"未被插件处理（未处理的协议）。Webpack默认支持"data:"和"file:" URI，您可能需要额外插件来处理"node:" URI。

问题原因 #

Webpack 5+ 默认不支持解析node:前缀的模块协议，你的项目（从路径判断是Next.js项目）中存在依赖或代码引入了node:events这类带node:前缀的模块，导致构建流程中断。

解决方案 #

方案1：修改Next.js的Webpack配置

在项目根目录的next.config.js中添加配置，处理node:协议并映射相关模块：

module.exports = {
  webpack: (config) => {
    // 为events模块添加fallback（未安装则先执行npm install events）
    config.resolve.fallback = {
      ...config.resolve.fallback,
      events: require.resolve('events'),
    };

    // 处理node:开头的模块协议
    config.module.rules.push({
      test: /node:/,
      use: 'null-loader',
    });

    return config;
  },
};

配置完成后安装所需依赖：

npm install events null-loader --save-dev

方案2：升级Next.js版本

新版本Next.js内置的Webpack已修复node:协议处理问题，直接升级到最新稳定版：

npm install next@latest --save

方案3：清理缓存后重新构建

修改配置或升级依赖后，清理旧构建文件与依赖缓存：

rm -rf node_modules .next package-lock.json
npm install
npm run build

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