node 17+ · npm
A mensagem
Error: error:0308010C:digital envelope routines::unsupported
O que significa
O node 17 passou a trazer o OpenSSL 3, que tirou dos padrões um algoritmo de hash antigo, e uma ferramenta que ainda o pede cai exatamente dentro dessa chamada. É quase sempre um webpack 4 antigo, ou uma ferramenta que embute um, rodando num node moderno. export NODE_OPTIONS=--openssl-legacy-provider reabilita os algoritmos antigos para aquele processo e é inofensivo para uma compilação. Mas isso mantém viva uma ferramenta morta: subir para o webpack 5, ou para a versão atual do seu framework, elimina de vez a necessidade da opção.
A correção
export NODE_OPTIONS=--openssl-legacy-provider- Impresso por
- node 17+
- npm
- 20
No npm a causa está na primeira linha code XXXX e não nas seis últimas linhas npm ERR!, e quando a falha vem da árvore de dependências ou de uma compilação nativa em vez do seu código, apagar node_modules e instalar de novo resolve metade dos casos.
Como ler uma mensagem de erro
- Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
- Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
- Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
- A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
- Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.
Perguntas frequentes
Q. O que significa “Error: error:0308010C:digital envelope routines::unsupported”?
O node 17 passou a trazer o OpenSSL 3, que tirou dos padrões um algoritmo de hash antigo, e uma ferramenta que ainda o pede cai exatamente dentro dessa chamada. É quase sempre um webpack 4 antigo, ou uma ferramenta que embute um, rodando num node moderno. export NODE_OPTIONS=--openssl-legacy-provider reabilita os algoritmos antigos para aquele processo e é inofensivo para uma compilação. Mas isso mantém viva uma ferramenta morta: subir para o webpack 5, ou para a versão atual do seu framework, elimina de vez a necessidade da opção.
Q. Como corrigir?
export NODE_OPTIONS=--openssl-legacy-provider — antes de rodar, veja acima o que este comando descarta.
Q. Qual ferramenta imprime isso?
node 17+. Fica em npm e a mensagem tem 4 palavras.