Base de Conhecimento

4.22 Como identificar arquivo de entrada incorreto na aplicação Node.js

A opção de gerenciamento de aplicações Node.js no cPanel serve para publicar, registrar e executar uma aplicação Node.js hospedada na conta. Um dos erros mais comuns nesse processo é informar um arquivo de entrada incorreto, também chamado de arquivo inicial, startup file ou entry point.

Na prática, este tutorial ensina como descobrir se o problema está no arquivo principal da aplicação, como localizar o nome correto e como ajustar isso para que a aplicação volte a iniciar normalmente.

Como acessar o cPanel

Você pode acessar o cPanel de três formas:

https://seudominio.com.br/cpanel
https://seudominio.com.br:2083
pela área do cliente MyWay, usando o atalho de acesso ao cPanel

O acesso normalmente exige o usuário e a senha da hospedagem, exceto quando a área do cliente oferece login automático.

Como identificar arquivo de entrada incorreto na aplicação Node.js

Para que serve este diagnóstico

Uma aplicação Node.js precisa de um arquivo inicial válido para que o Passenger consiga carregá-la. Esse arquivo costuma ser algo como app.js, server.js, index.js ou outro nome definido no projeto.

Se o arquivo configurado estiver errado, a aplicação poderá:

não iniciar
retornar erro 500
exibir página vazia
mostrar erro de inicialização nos logs

Passo 1 – Verificar qual arquivo foi configurado

Entre na área da aplicação Node.js e procure o campo relacionado ao arquivo inicial.

Traduções úteis:

Startup File = Arquivo de inicialização
Application Startup File = Arquivo inicial da aplicação
Entry Point = Ponto de entrada

Veja exatamente qual nome está cadastrado.

Se estiver configurado, por exemplo, app.js, mas o projeto usa server.js, a aplicação não subirá corretamente.

Passo 2 – Conferir os arquivos reais da aplicação

Abra o Gerenciador de Arquivos do cPanel ou o Terminal, entre na pasta da aplicação e verifique quais arquivos existem.

Exemplos comuns:

app.js
server.js
index.js
bin/www em projetos adaptados do Express

O nome do arquivo deve coincidir exatamente, inclusive com letras maiúsculas e minúsculas quando aplicável.

Passo 3 – Consultar o package.json

Se existir um arquivo package.json, abra-o e procure principalmente:

o campo main
os scripts, especialmente start

Exemplos:

"main": "server.js"
"start": "node app.js"

O package.json costuma indicar claramente qual é o arquivo principal ou qual comando normalmente inicia o projeto.

Passo 4 – Entender sinais de arquivo incorreto

Os indícios mais comuns são:

erro informando que o módulo não foi encontrado
erro dizendo que o arquivo não existe
aplicação fica registrada, mas não responde
log menciona caminho inválido

Exemplos típicos:

Cannot find module
No such file or directory
App failed to start

Passo 5 – Corrigir o nome do arquivo inicial

Depois de identificar o arquivo correto, ajuste a configuração da aplicação e salve.

Se necessário:

edite o campo do arquivo inicial
confirme se a pasta raiz da aplicação também está correta
reinicie a aplicação

Quando o arquivo inicial está correto, a aplicação volta a carregar o código certo e passa a responder normalmente no endereço publicado.

Cuidados importantes

não confunda o arquivo principal com arquivos auxiliares
não use caminho incorreto dentro de outra pasta sem necessidade
confira se o arquivo exporta ou executa corretamente o servidor HTTP
em projetos adaptados, às vezes é necessário criar um arquivo de inicialização específico para o ambiente hospedado

Mesmo com o nome correto, a aplicação ainda pode falhar se faltar dependência, variável de ambiente ou se o código estiver incompatível com a versão do Node.js.

Resultado esperado

Ao final, você terá identificado qual arquivo realmente inicia o projeto e terá corrigido a configuração da aplicação no cPanel.

Resumo prático:

1. Acesse a área da aplicação Node.js
2. Veja qual arquivo inicial foi configurado
3. Compare com os arquivos reais da pasta
4. Consulte o package.json
5. Corrija o nome do arquivo inicial
6. Reinicie a aplicação
7. Teste o acesso no navegador

MyWay Hosting
Servidores Otimizados por inteligência artificial
www.myway.com.br

0 Usuários acharam útil