Olá a todos, meu nome é Asim Khan e atualmente sou desenvolvedor full stack na Meta Melon. Recentemente, encontrei um problema frustrante enquanto trabalhava em um projeto para Naseebi.com, um aplicativo matrimonial para celular e web. O problema envolveu a descontinuação do módulo punycode no Node.js, e quero compartilhar minha experiência e solução com você.

O problema

Enquanto trabalhava no recurso de criação de perfil no aplicativo, encontrei um erro 502 Bad Gateway. Depois de verificar os logs do meu servidor no AWS EC2, encontrei este aviso:

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

Isso foi estranho porque eu não usei punycode diretamente em meu código. No entanto, depois de inspecionar meu arquivo package-lock.json, descobri que ele foi incluído como uma dependência em algum lugar do projeto. Minha versão do Node.js na época era v22.0.0. Tentei fazer downgrade para v20.9.0 e até v18.18.0, mas o aviso persistiu.

Compreendendo o problema

O módulo punycode foi descontinuado no Node.js versão 21. Para resolver isso, precisei substituí-lo pela alternativa de usuário recomendada, punycode.js. No entanto, simplesmente instalar o módulo userland não pareceu ajudar.

Soluções e soluções alternativas

Aqui estão as etapas que executei para finalmente resolver o problema:

1. Faça downgrade da versão do Node.js.

Se você não tem interesse em usar a versão mais recente do Node.js, uma solução rápida é fazer o downgrade para uma versão anterior à 21.

nvm install 20.5.1
nvm use 20.5.1

2. Identifique as dependências problemáticas

Você pode executar npm ls punycode para identificar quais dependências ainda estão usando punycode.

npm ls punycode

No meu caso, os culpados foram ajv e whatwg-url-without-unicode. Eu encontrei isso através das seguintes etapas:

Atualizando ajv: atualizei o ajv em meu arquivo package.json.

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

Atualizando whatwg-url: atualizei whatwg-url também.

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

Após essas atualizações, o aviso desapareceu. No entanto, se o problema persistir, você pode seguir as etapas a seguir.

3. Suprimir o aviso (correção temporária)

Você pode suprimir o aviso em seus scripts package.json:

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

Isso removerá os avisos de descontinuação da saída do console.

4. Use pm2 para gerenciar seu aplicativo

Finalmente, percebi que um dos meus dois clusters estava inativo, então adicionei um arquivo ecossistema.config.js na raiz do projeto para gerenciar meu aplicativo com 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,
    },
  ],
};

Depois de enviar o código e puxá-lo no EC2, reiniciei o servidor pm2 e tudo começou a funcionar perfeitamente.

Conclusão

Esse problema me ensinou muito sobre como gerenciar dependências e como lidar com módulos obsoletos. Embora o módulo punycode esteja obsoleto, você ainda pode usá-lo temporariamente, mas é melhor resolver o problema agora para evitar problemas no futuro. Espero que este guia ajude você se você encontrar um problema semelhante.