解决 Node.js 中的“Punycode 模块已弃用”问题

大家好，我叫 Asim Khan，目前是 Meta Melon 的一名全栈开发者。最近，我在Naseebi.com（一个婚恋移动和 Web 应用）的项目上遇到了一个令人沮丧的问题。这个问题与 Node.js 中 Punycode 模块的弃用有关，我想与大家分享我的经验和解决方案。

Punycode

Punycode 是一种将域名（例如“你好.com”）中的国际字符转换为与域名系统 (DNS) 兼容的格式的方法，DNS 仅识别 ASCII 字符。它确保非英语域名的全球可访问性。

示例：
原文（Unicode）：müller.de
Punycode（ASCII）：xn--mller-kva.de
当用户输入 müller.de 时，浏览器会将其转换为 xn--mller-kva.de，以便 DNS 可以处理它。

问题

在应用程序中使用配置文件创建功能时，我遇到了 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，但警告仍然存在。

理解问题

punycode 模块在 Node.js 21 版中已被弃用。为了解决这个问题，我需要用推荐的用户级替代方案 punycode.js 来替换它。然而，仅仅安装用户级模块似乎并没有帮助。

解决方案和解决方法

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

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 模块已被弃用，但您仍然可以暂时使用它，但最好现在就解决这个问题，以免将来出现问题。如果您遇到类似的问题，希望本指南能对您有所帮助。