Node.js の「Punycode モジュールは非推奨です」問題の解決-jsチュートリアル-php.cn

Node.js の「Punycode モジュールは非推奨です」問題の解決

WBOY

リリース： 2024-08-24 11:35:34

オリジナル

695 人が閲覧しました

Solving the

皆さん、こんにちは。私の名前は Asim Khan です。現在、Meta Melon でフルスタック開発者を務めています。最近、結婚向けのモバイルおよび Web アプリケーションである Naseebi.com のプロジェクトに取り組んでいるときに、イライラする問題に遭遇しました。この問題には、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 にダウングレードしようとしましたが、警告が表示され続けました。

問題を理解する

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 を使用してアプリケーションを管理する

最後に、2 つのクラスターのうち 1 つがダウンしていることに気づき、pm2 でアプリケーションを管理するためにプロジェクトルートに Ecosystem.config.js ファイルを追加しました。

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 サーバーを再起動すると、すべてがスムーズに動作し始めました。