Como corrigir o erro de servidor do Mastodon ao atualizar o perfil

Ao tentar salvar alterações no seu perfil do Mastodon, você pode ver uma mensagem genérica de “Erro de Servidor” em vez de uma atualização bem-sucedida. Esse erro pode aparecer após editar seu nome de exibição, biografia, avatar, imagem de cabeçalho ou qualquer outro campo do perfil. O problema geralmente é causado por um arquivo muito grande, um cache do navegador corrompido ou um problema temporário no servidor da sua instância do Mastodon. Este artigo explica as causas raiz do erro e fornece correções passo a passo para ajudar você a salvar as alterações do perfil com sucesso.

Por que o Mastodon mostra um erro de servidor ao atualizar o perfil

A mensagem “Erro de Servidor” no Mastodon aparece quando o servidor não consegue processar a solicitação de atualização por um dos vários motivos. A causa mais comum é um arquivo de imagem que excede o tamanho máximo de upload da instância. As instâncias do Mastodon geralmente limitam imagens de avatar e cabeçalho a 2 MB por arquivo. Se você enviar um arquivo maior, o servidor o rejeita e retorna um erro genérico.

Uma segunda causa frequente é um cache ou cookie do navegador corrompido para a instância do Mastodon. Quando o cache armazena dados de sessão desatualizados ou arquivos CSS incompletos, o navegador pode enviar uma solicitação malformada ao servidor. O servidor então não consegue analisar a solicitação e retorna um erro interno 500.

Uma terceira causa é um problema temporário no servidor, como um timeout de conexão com o banco de dados ou um disco cheio no servidor da instância. Esses problemas são raros, mas podem afetar qualquer instância do Mastodon durante períodos de alta carga ou manutenção.

Por fim, extensões do navegador como bloqueadores de anúncios, ferramentas de privacidade ou gerenciadores de script podem interferir no formulário de atualização do perfil. Essas extensões podem bloquear o código JavaScript que o Mastodon usa para validar e enviar dados do formulário.

Passos para corrigir o erro de servidor no formulário de atualização do perfil

Siga estes passos em ordem. Após cada passo, tente salvar seu perfil novamente. Se o erro persistir, vá para o próximo passo.

1. Verifique o tamanho do arquivo de imagem do seu avatar ou cabeçalho
   Abra o Explorador de Arquivos no Windows ou o Finder no macOS. Clique com o botão direito no arquivo de imagem que você está tentando enviar e selecione Propriedades ou Obter Informações. Veja o tamanho do arquivo. Se exceder 2 MB, redimensione a imagem usando um editor de imagens ou uma ferramenta online gratuita como Pixlr ou Canva. Salve a imagem redimensionada como JPEG ou PNG com tamanho inferior a 2 MB.
2. Remova temporariamente as imagens de avatar e cabeçalho
   Vá em Preferências > Aparência > Editar Perfil. Clique no botão Remover ao lado dos campos de avatar e imagem de cabeçalho. Deixe ambos os campos vazios. Clique em Salvar Alterações. Se o salvamento for bem-sucedido, o erro foi causado por uma das imagens. Reenvie cada imagem uma de cada vez, salvando após cada upload, para identificar qual arquivo causou o problema.
3. Limpe o cache e os cookies do navegador para a instância do Mastodon
   No Chrome, clique no menu de três pontos > Configurações > Privacidade e segurança > Limpar dados de navegação. Defina o intervalo de tempo como Todo o período. Marque ambas as opções Cookies e outros dados do site e Imagens e arquivos em cache. Clique em Limpar dados. No Firefox, clique no menu > Configurações > Privacidade e Segurança > Cookies e Dados do Site > Limpar Dados. Marque ambas as opções e clique em Limpar. Reinicie o navegador e tente salvar seu perfil novamente.
4. Use uma janela privada do navegador ou um navegador diferente
   Abra uma janela privada ou anônima no seu navegador atual. No Chrome, pressione Ctrl+Shift+N. No Firefox, pressione Ctrl+Shift+P. Faça login na sua instância do Mastodon na janela privada. Vá em Preferências > Aparência > Editar Perfil. Faça uma pequena alteração, como adicionar um caractere ao seu nome de exibição, e clique em Salvar Alterações. Se o salvamento funcionar na janela privada, o problema é causado por dados em cache ou uma extensão na sua sessão normal do navegador.
5. Desative temporariamente as extensões do navegador
   No Chrome, clique no menu de três pontos > Extensões > Gerenciar Extensões. Desative todas as extensões. No Firefox, clique no menu > Complementos e temas > Extensões. Desative cada extensão. Tente salvar seu perfil novamente. Se funcionar, ative as extensões uma por uma até encontrar a que está causando o conflito. Mantenha essa extensão desativada ou adicione uma exceção para sua instância do Mastodon.
6. Tente uma rede diferente ou desative a VPN
   Se você usa uma VPN ou proxy, desconecte-o temporariamente. Conecte-se a uma rede Wi-Fi diferente ou use um hotspot móvel. Tente salvar seu perfil novamente. Algumas instâncias do Mastodon bloqueiam solicitações de determinadas faixas de IP, especialmente se o IP estiver associado a spam ou abuso.
7. Entre em contato com o administrador da sua instância
   Se nenhum dos passos acima funcionar, o erro pode ser do lado do servidor. Envie uma mensagem privada para o administrador da sua instância ou verifique o canal de suporte da instância. Inclua a mensagem de erro exata, o horário em que ocorreu e os passos que você já tentou. O administrador pode verificar os logs do servidor para o erro 500 específico e identificar a causa.

Se o Mastodon ainda mostrar um erro de servidor após a correção principal

Erro de servidor aparece apenas ao enviar uma imagem específica

Se o erro ocorrer apenas com um arquivo de imagem, o arquivo pode estar corrompido ou salvo em um formato não suportado. O Mastodon suporta JPEG, PNG e GIF para avatares e cabeçalhos. Converta o arquivo para JPEG ou PNG usando um editor de imagens. Reduza as dimensões para 400×400 pixels para avatares e 1500×500 pixels para cabeçalhos. Salve o arquivo com um novo nome e tente enviá-lo novamente.

Erro de servidor aparece em todo salvamento de perfil, mesmo sem alterações

Se você não conseguir salvar o perfil mesmo sem fazer alterações, o problema provavelmente é uma sessão corrompida ou um problema no servidor. Faça logout completo da sua instância do Mastodon. Limpe o cache e os cookies do navegador para o domínio da instância. Faça login novamente e tente salvar o perfil com uma alteração mínima. Se o erro persistir, entre em contato com o administrador da sua instância.

Erro de servidor aparece no navegador móvel, mas não no desktop

Navegadores móveis às vezes aplicam compressão ou cache adicional que interfere no envio do formulário do Mastodon. Limpe o cache do navegador no seu dispositivo móvel. Alternativamente, use o aplicativo móvel do Mastodon para iOS ou Android para atualizar seu perfil. O aplicativo usa um endpoint de API separado que pode contornar o problema relacionado ao navegador.

Métodos de atualização do perfil do Mastodon: navegador vs aplicativo móvel

Item	Navegador (Desktop ou Móvel)	Aplicativo Móvel do Mastodon
Acesso ao formulário de perfil	Preferências > Aparência > Editar Perfil	Toque no seu avatar > Editar Perfil
Limite de upload de imagem	Geralmente 2 MB por arquivo	Geralmente 2 MB por arquivo
Interferência de cache	Causa frequente de erros de servidor	Causa rara de erros de servidor
Conflitos com extensões do navegador	Possível	Não se aplica
Facilidade de limpar o cache	Requer etapas manuais nas configurações do navegador	O cache do aplicativo pode ser limpo nas configurações do app

Agora você pode corrigir o erro de servidor do Mastodon no formulário de atualização do perfil verificando o tamanho do arquivo de imagem, limpando o cache do navegador ou usando uma janela privada do navegador. Se o erro persistir, tente o aplicativo móvel ou entre em contato com o administrador da sua instância. Como dica avançada, use um editor de imagens para salvar suas imagens de avatar e cabeçalho como arquivos JPEG progressivos, que o Mastodon processa de forma mais confiável do que arquivos JPEG padrão.