NextJS执行npm run build时出现punycode模块弃用警告如何解决？

第一步：定位触发警告的依赖 #

这个警告是某个间接依赖在调用Node.js已废弃的内置punycode模块导致的，先找出具体是哪个依赖：

• 修改package.json里的build命令，添加追踪参数：

  "scripts": {
    "build": "node --trace-deprecation ./node_modules/.bin/next build"
  }
  

• 重新运行npm run build，输出里会显示完整的调用栈，找到引入punycode的依赖包名称。

第二步：针对性解决问题 #

根据找到的依赖，选择对应方案：

• 升级依赖：如果该依赖有更新版本，执行npm update [依赖名]，新版本大概率已经替换了废弃的punycode调用（比如改用社区维护的punycode.js）。
• 替换依赖：若依赖长期未更新且无修复版本，寻找功能替代的其他包替换掉它。
• 临时抑制警告：如果暂时无法解决依赖问题，可修改build命令隐藏警告（仅临时过渡，不推荐长期使用）：

  "scripts": {
    "build": "node --no-warnings ./node_modules/.bin/next build"
  }
  

注意事项 #

不要盲目执行npm install punycode——Node.js内置的punycode已废弃，手动安装的用户land版本无法直接替换内置模块的调用，除非依赖明确兼容该版本，否则只会增加冗余依赖，无法解决警告。

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