解决 Nodejs 中的“Punycode Module is Deprecated”问题

大家好，我叫 asim khan，目前是 meta melon 的全栈开发人员。最近，我在为 naseebi.com（一个婚姻移动和 web 应用程序）项目工作时遇到了一个令人沮丧的问题。该问题涉及 node.js 中 punycode 模块的弃用，我想与您分享我的经验和解决方案。

问题

在应用程序中使用配置文件创建功能时，我遇到了 502 bad gateway 错误。在检查 aws ec2 上的服务器日志后，我发现了以下警告：

the punycode module is deprecated. please use a userland alternative instead. (use node --trace-deprecation ... to show where the warning was created)

这很奇怪，因为我没有直接在我的代码中使用 punycode。但是，在检查我的 package-lock.json 文件后，我发现它作为依赖项包含在项目中的某个位置。我当时的 node.js 版本是 v22.0.0。我尝试降级到 v20.9.0 甚至 v18.18.0，但警告仍然存在。

了解问题

node.js 版本 21 中已弃用 punycode 模块。为了解决此问题，我需要将其替换为推荐的用户层替代方案 punycode.js。然而，简单地安装 userland 模块似乎没有帮助。

解决方案和解决方法

以下是我最终解决问题所采取的步骤：

1.降级node.js版本

如果你不介意使用最新的 node.js 版本，快速修复方法是降级到 21 之前的版本。

nvm install 20.5.1
nvm use 20.5.1

2. 识别有问题的依赖关系

您可以运行 npm ls punycode 来识别哪些依赖项仍在使用 punycode。

npm ls punycode

就我而言，罪魁祸首是 ajv 和 whatwg-url-without-unicode。我通过以下步骤找到了这些：

更新 ajv：我在 package.json 文件中更新了 ajv。

"overrides": {
  "ajv": "^8.17.1"
}

更新whatwg-url：我也更新了whatwg-url。

"overrides": {
  "ajv": "^8.17.1",
  "whatwg-url": "^14.0.0"
}

这些更新之后，警告消失了。但是，如果问题仍然存在，您可以使用以下步骤。

3.抑制警告（临时修复）

您可以在 package.json 脚本中抑制警告：

"scripts": {
  "start": "node_no_warnings=1 vite"
}

这将从控制台输出中删除弃用警告。

4.使用 pm2 来管理您的应用程序

最后，我意识到我的两个集群之一宕机了，所以我在项目根目录中添加了一个 ecosystem.config.js 文件来使用 pm2 管理我的应用程序。

module.exports = {
  apps: [
    {
      name: "my-app",
      script: "npm",
      args: "run start",
      instances: "max",
      exec_mode: "cluster",
      max_memory_restart: "1G",
      watch: false,
      autorestart: true,
      restart_delay: 5000,
    },
  ],
};

在 ec2 上推送代码并将其拉取后，我重新启动了 pm2 服务器，一切开始顺利进行。

结论

这个问题教会了我很多关于管理依赖项和处理已弃用模块的知识。虽然 punycode 模块已被弃用，但您仍然可以暂时使用它，但最好现在就解决该问题，以避免将来出现问题。如果您遇到类似问题，希望本指南对您有所帮助。