Привет всем, меня зовут Асим Хан, и в настоящее время я работаю разработчиком полного стека в Meta Melon. Недавно я столкнулся с неприятной проблемой во время работы над проектом Naseebi.com, супружеского мобильного и веб-приложения. Проблема заключалась в прекращении поддержки модуля punycode в Node.js, и я хочу поделиться с вами своим опытом и решением.

Проблема

При работе над функцией создания профиля в приложении я столкнулся с ошибкой 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. Я попытался перейти на версию 20.9.0 и даже на версию 18.18.0, но предупреждение не исчезло.

Понимание проблемы

Модуль punycode устарел в Node.js версии 21. Чтобы решить эту проблему, мне нужно было заменить его рекомендуемой альтернативой пользовательского пространства — 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: я обновил ajv в своем файле package.json.

"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 для управления своим приложением

Наконец, я понял, что один из двух моих кластеров не работает, поэтому добавил файл экосистемы.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 устарел, вы все равно можете временно использовать его, но лучше решить эту проблему сейчас, чтобы избежать проблем в будущем. Надеюсь, это руководство поможет вам, если вы столкнетесь с подобной проблемой.