解決 Node.js 中的「Punycode 模組已棄用」問題

大家好，我叫 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。然而，僅僅安裝用戶層模組似乎沒有幫助。

解決方案和解決方法

以下是我最終解決該問題所採取的步驟：

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 模組已被棄用，但您仍然可以暫時使用它，但最好現在就解決該問題，以避免將來出現問題。如果您遇到類似問題，希望本指南對您有所幫助。

以上是解決 Node.js 中的「Punycode 模組已棄用」問題的詳細內容。更多資訊請關注PHP中文網其他相關文章！