Como diagnosticar erro 'Text file busy' em script em execução Print

Como diagnosticar o erro "Text file busy" em um script em execução

Olá, querido(a) cliente! 🌟

Antes de tudo, lembre-se: você não está sozinho. Todos nós já passamos por isso. A GeHost está aqui para te ajudar com carinho e clareza. Vamos juntos?

O que significa "Text file busy"?

Esse erro aparece quando o sistema operacional está tentando acessar um arquivo de script (como um .php, .sh ou .py), mas o arquivo está sendo usado por outro processo em execução — ou seja, está "ocupado". É como se você tentasse abrir um livro que alguém está lendo no momento.

Isso geralmente acontece quando:

• Um script está rodando e não foi encerrado corretamente.
• O servidor tenta reiniciar um script, mas ele ainda está ativo.
• O arquivo foi editado recentemente e o sistema ainda o está carregando.

Passo a passo: Como diagnosticar e resolver

1. Verifique se há scripts em execução

   Às vezes, um script pode ter sido iniciado e travado. Para saber se isso está acontecendo, acesse o Gerenciador de Arquivos no cPanel.

   

2. Localize o script que está causando o erro

   Procure o arquivo que você está tentando executar (por exemplo, backup.php ou processa_dados.sh). Ele geralmente está dentro da pasta public_html ou em uma subpasta como scripts.

   Se o arquivo estiver sendo editado ou modificado por outro processo, o erro "Text file busy" pode aparecer.

3. Verifique se o script está em execução em segundo plano

   Se você estiver usando comandos como nohup, screen ou tmux, pode ser que o script ainda esteja rodando em segundo plano.

   Para verificar, entre no seu servidor via SSH (se tiver acesso) e digite:

   ps aux | grep nome_do_seu_script

   Se aparecer uma linha com o nome do seu script, ele está em execução. Você pode encerrá-lo com:

   kill PID_do_script

   Substitua PID_do_script pelo número que apareceu na lista.

4. Reinicie o servidor de aplicativos (se necessário)

   Às vezes, o problema não está no script em si, mas no serviço que o executa (como o PHP-FPM ou Apache).

   Se você tem acesso ao painel de controle, vá até “Métricas” no cPanel:

   

   Verifique se há picos de uso de CPU ou memória. Se sim, pode ser que o servidor esteja sobrecarregado. Nesse caso, reiniciar o serviço pode ajudar.

5. Evite editar arquivos em uso

   Se o erro aparecer ao editar um script, pare de editar! O sistema pode estar lendo o arquivo enquanto você o modifica.

   Se precisar fazer alterações, faça uma cópia do arquivo com outro nome (ex: script.php.bak) e edite a cópia. Depois, substitua o original apenas quando o script não estiver em execução.

6. Reinicie o script após a correção

   Depois de encerrar o processo antigo e garantir que o arquivo não está sendo usado, tente rodar o script novamente.

   Se o erro persistir, pode ser um problema de permissão. Verifique se o arquivo tem permissão de leitura e execução (normalmente 644 ou 755).

Dicas práticas para evitar o erro no futuro

• Nunca force o encerramento de um script sem verificar — isso pode deixar o arquivo "travado".
• Use nomes de arquivos únicos para scripts de tarefas agendadas (ex: backup_20250405.php).
• Evite editar arquivos que estão sendo executados — espere o processo terminar.
• Use o cron com cuidado — configure intervalos seguros para não sobrecarregar o servidor.

Quer ajuda extra?

Se mesmo após seguir todos os passos o erro persistir, não hesite em nos chamar! 💌

É só entrar em contato com nosso suporte via chat ao vivo ou enviar um ticket. Nós vamos te ajudar a investigar o que está acontecendo, com paciência e atenção — como um bom amigo.

Seu site é importante. Nós cuidamos dele com carinho, assim como cuidamos de você. 💙

Até a próxima, e lembre-se: todo erro é uma oportunidade de aprender. Você está no caminho certo!