Como Corrigir o Upload de Imagem Travado em ‘Processando’ no Mastodon

Quando você faz upload de uma imagem no Mastodon e o indicador de progresso trava em “Processando” indefinidamente, a postagem não pode ser publicada. Esse problema afeta tanto a interface web quanto os aplicativos móveis, impedindo que a mídia apareça em suas postagens. A causa raiz geralmente é uma falha no processamento de mídia do servidor, um problema de formato de arquivo ou um conflito de cache do navegador. Este artigo explica por que a etapa de processamento trava e fornece etapas específicas para resolver o problema rapidamente.

Por que o Mastodon trava em “Processando” durante o upload de imagem

O Mastodon não armazena imagens enviadas em sua forma original. Quando você anexa um arquivo, o servidor executa um pipeline de processamento de mídia que gera miniaturas, redimensiona o arquivo e extrai metadados. Esse pipeline usa um sistema de trabalhos em segundo plano chamado Sidekiq. Se o Sidekiq estiver sobrecarregado, mal configurado ou o arquivo de imagem contiver dados não suportados, o trabalho nunca é concluído. A interface web mostra “Processando” indefinidamente porque está aguardando um sinal de sucesso do trabalhador em segundo plano que nunca chega.

Gatilhos comuns incluem:

• Imagens com resolução muito alta (acima de 4000 pixels no lado mais longo) que excedem o limite de tempo de processamento do servidor.
• Arquivos salvos com perfis de cor não suportados, como CMYK ou Adobe RGB.
• Arquivos PNG ou WebP animados que a biblioteca de imagens do servidor não consegue decodificar.
• Uma fila do Sidekiq cheia causada por muitos usuários enviando mídia simultaneamente.
• Cache do navegador desatualizado ou corrompido armazenando um arquivo JavaScript antigo que lida com o callback de progresso do upload.

Etapas para corrigir o upload de imagem travado

Método 1: Limpar o cache do navegador e atualizar a página

1. Abra as ferramentas de desenvolvedor do navegador
   Pressione Ctrl+Shift+I no Windows ou Cmd+Option+I no Mac para abrir o DevTools.
2. Vá para a guia Application ou Storage
   No Chrome ou Edge, clique na guia Application. No Firefox, clique em Storage. No Safari, clique na guia Storage.
3. Limpe o cache para o domínio da sua instância
   Expanda a seção Cache, selecione Cache Storage, clique com o botão direito no domínio da sua instância do Mastodon (por exemplo, mastodon.social) e escolha Delete. Também limpe o cache HTTP clicando em Clear site data no painel Application.
4. Recarregue a página do Mastodon
   Pressione Ctrl+F5 ou Cmd+Shift+R para forçar um recarregamento completo da página. Tente fazer o upload da imagem novamente.

Método 2: Converter a imagem para um formato compatível e tamanho menor

1. Verifique o formato da imagem
   O Mastodon suporta JPEG, PNG, GIF e WebP. Evite TIFF, BMP, HEIC e SVG.
2. Reduza a resolução para menos de 2000 pixels no lado mais longo
   Use um editor de imagens como Paint no Windows, Preview no Mac ou uma ferramenta online gratuita como Pixlr. Redimensione a imagem para 1920×1080 ou menor.
3. Converta para o perfil de cor sRGB
   Se você usou um editor de fotos profissional, exporte a imagem com o perfil de cor sRGB IEC61966-2.1. A biblioteca de imagens do Mastodon pode falhar em perfis Adobe RGB ou ProPhoto RGB.
4. Salve como JPEG com qualidade 85% ou como PNG-24
   Arquivos JPEG com menos de 10 MB processam mais rápido. Arquivos PNG com transparência são suportados, mas devem ter menos de 5 MB.
5. Faça upload do arquivo convertido
   Arraste o novo arquivo para o compositor do Mastodon. Aguarde dez segundos. Se o indicador de processamento ainda aparecer, vá para o Método 3.

Método 3: Verificar a fila de processamento de mídia da sua instância

1. Abra o painel do Sidekiq
   Adicione /sidekiq à URL da sua instância. Por exemplo, se sua instância é mastodon.social, vá para https://mastodon.social/sidekiq. Você deve estar logado como administrador ou moderador.
2. Verifique as guias Busy e Enqueued
   Clique na guia Busy. Procure por trabalhos chamados MediaProcessingWorker ou ThumbnailGenerationWorker. Se houver muitos trabalhos ocupados, o servidor está sobrecarregado. Clique na guia Enqueued e verifique a fila padrão. Um número alto significa que os trabalhos estão esperando.
3. Reinicie o Sidekiq se a fila parecer travada
   Se o mesmo trabalho permanecer em Busy por mais de cinco minutos sem progresso, o trabalhador pode estar em deadlock. Peça ao administrador da sua instância para reiniciar o Sidekiq com o comando systemctl restart mastodon-sidekiq no servidor.
4. Aguarde a fila esvaziar
   Se a fila estiver simplesmente cheia, aguarde quinze minutos e tente fazer o upload novamente. Instâncias grandes podem sofrer atrasos durante horários de pico.

Método 4: Desativar extensões do navegador que interferem nos uploads

1. Abra o gerenciador de extensões do seu navegador
   No Chrome, vá para chrome://extensions. No Firefox, vá para about:addons. No Edge, vá para edge://extensions.
2. Desative bloqueadores de conteúdo e gerenciadores de script
   Desative temporariamente uBlock Origin, NoScript, Privacy Badger ou extensões semelhantes. Elas podem bloquear o JavaScript que reporta o progresso do upload.
3. Recarregue o Mastodon e faça o upload novamente
   Se o upload for bem-sucedido, reative as extensões uma por uma para identificar a culpada. Adicione uma exceção para sua instância do Mastodon nas configurações da extensão.

Se o Mastodon ainda mostrar “Processando” após a correção principal

O upload funciona em uma janela de navegação privada, mas não na janela principal do navegador

Isso confirma que a causa é um cache corrompido ou uma extensão no perfil principal. Limpe todos os dados do site para sua instância do Mastodon nas configurações principais do navegador. Vá para Configurações > Privacidade e segurança > Cookies e outros dados do site > Ver todos os dados do site. Pesquise pelo domínio da sua instância e clique em Remover.

O upload falha no aplicativo móvel, mas funciona na web

O aplicativo móvel pode usar um endpoint de processamento de mídia diferente. Force o fechamento do aplicativo, limpe o cache nas configurações do sistema e reinicie o telefone. Se o problema persistir, desinstale e reinstale o aplicativo da loja oficial.

O upload falha em todos os dispositivos e navegadores

O problema é do lado do servidor. O armazenamento de mídia da instância pode estar cheio ou o processo do Sidekiq pode ter travado. Entre em contato com o administrador da sua instância e peça para verificar os logs do Mastodon com journalctl -u mastodon-web -n 50 e verificar o espaço livre em disco com df -h.

Uploads de imagem funcionam, mas uploads de vídeo travam

A transcodificação de vídeo requer mais CPU e memória do que o processamento de imagem. A instância pode ter um limite de tamanho de arquivo para vídeos, geralmente 40 MB. Converta seu vídeo para MP4 com codificação H.264, resolução de 720p ou inferior e taxa de bits abaixo de 2 Mbps. Se o problema continuar, o servidor pode não ter FFmpeg ou ter um tempo limite de transcodificação mal configurado.

Upload de imagem vs upload de vídeo no Mastodon: diferenças de processamento

Item	Upload de imagem	Upload de vídeo
Trabalhador em segundo plano	MediaProcessingWorker	VideoProcessingWorker
Tempo de processamento típico	1 a 5 segundos	10 segundos a 2 minutos
Causa comum de travamento	Perfil de cor não suportado ou cache corrompido	FFmpeg ausente ou disco cheio
Limite de tamanho de arquivo	10 MB (padrão)	40 MB (padrão)
Limite de resolução	2000 px no lado mais longo	1920×1080

Após aplicar as etapas acima, seus uploads de imagem no Mastodon devem ser concluídos em alguns segundos. Se você gerencia sua própria instância, monitore o painel do Sidekiq regularmente para detectar acúmulos de fila precocemente. Para problemas recorrentes, configure um cron job que reinicie o Sidekiq todas as noites em horários de baixo tráfego para limpar trabalhadores travados automaticamente.