Ao enviar uma nova foto de perfil no Mastodon, o servidor precisa redimensionar e otimizar a imagem antes que ela fique visível para outros. O erro “Avatar image failed to process” indica que essa operação no servidor não pôde ser concluída. Essa falha geralmente ocorre porque o arquivo de imagem viola um dos requisitos técnicos rigorosos do Mastodon. Este artigo explica os limites específicos de formato, tamanho e dimensão que disparam o erro e o que você pode fazer para corrigir cada causa.
Resumo: Limites de Upload de Avatar no Mastodon
- Tamanho máximo do arquivo: 2 MB: Uploads maiores que isso são rejeitados antes do processamento.
- Formatos de imagem permitidos: PNG, GIF, JPG, JPEG, WebP: Todos os outros formatos, como BMP, TIFF ou SVG, falharão.
- Dimensões máximas: 336 x 336 pixels: O Mastodon redimensiona todos os avatares para este tamanho quadrado; imagens com proporções extremas podem causar erros de processamento.
Por que o Mastodon Rejeita ou Falha ao Processar uma Imagem de Avatar
O Mastodon usa a biblioteca ImageMagick em seu backend para converter imagens enviadas em formatos padronizados. Quando você envia um avatar, o servidor realiza três verificações em sequência: validação do formato do arquivo, verificação do tamanho do arquivo e processamento das dimensões da imagem. Se qualquer uma dessas verificações falhar, o servidor retorna a mensagem de erro genérica “Avatar image failed to process”. O erro não é específico sobre qual limite foi violado, então você deve verificar cada condição manualmente.
O pipeline de processamento de avatar também aplica conversão de perfil de cores e remoção de dados EXIF. Imagens com metadados corrompidos ou perfis de cores não suportados podem fazer o ImageMagick travar, resultando no mesmo erro. Entender essas três causas raiz ajuda você a preparar uma imagem compatível antes do upload.
Restrições de Formato de Arquivo
O Mastodon aceita apenas cinco formatos de imagem para avatares: PNG, GIF, JPG, JPEG e WebP. Se você enviar um BMP, TIFF, SVG, HEIC ou qualquer outro formato, o servidor rejeitará o arquivo imediatamente. Alguns dispositivos móveis salvam fotos no formato HEIC por padrão, que não é suportado. Você deve converter esses arquivos para um dos formatos aceitos antes de enviar.
Limite de Tamanho de Arquivo
O tamanho máximo permitido para um avatar é de 2 megabytes. Esse limite se aplica ao arquivo original antes de qualquer redimensionamento. Imagens tiradas com câmeras de smartphones modernos geralmente excedem 2 MB mesmo após o corte. Você deve reduzir o tamanho do arquivo usando software de edição de imagem ou ferramentas de compressão online antes de enviar.
Restrições de Dimensão da Imagem
O Mastodon redimensiona todos os avatares para um quadrado de 336 por 336 pixels. Embora você possa enviar imagens com dimensões maiores, o servidor precisa processá-las primeiro. Imagens com proporções extremas, como panoramas muito largos ou retratos muito altos, podem fazer a etapa de processamento falhar. A abordagem recomendada é cortar sua imagem para uma proporção quadrada de 1:1 antes de enviar, com dimensões de pelo menos 336 x 336 pixels.
Passos para Verificar e Corrigir um Upload de Avatar com Falha
- Verifique o formato do arquivo da sua imagem
Clique com o botão direito no arquivo de imagem no Windows e selecione Propriedades. Na guia Geral, veja a entrada “Tipo de arquivo”. Deve ser PNG, GIF, JPG, JPEG ou WebP. Se for qualquer outra coisa, abra a imagem em um editor como o Paint e use Arquivo > Salvar como para salvá-la como PNG ou JPEG. - Verifique se o tamanho do arquivo é inferior a 2 MB
Na mesma janela de Propriedades, verifique o valor de Tamanho. Se o arquivo for maior que 2 MB, comprima-o. No Windows, abra a imagem no Paint, selecione Redimensionar, reduza a porcentagem para 50, depois use Arquivo > Salvar como para salvar como JPEG. Isso geralmente reduz o tamanho para abaixo de 2 MB. Alternativamente, use uma ferramenta online gratuita como TinyPNG ou Squoosh. - Corte a imagem para uma proporção quadrada
Abra a imagem no Paint. Clique na ferramenta Selecionar e arraste uma seleção quadrada ao redor da área que você deseja usar como avatar. Clique em Cortar, depois use Arquivo > Salvar como para salvar a versão cortada. Isso garante que a imagem tenha uma proporção de 1:1, evitando erros de processamento causados por dimensões extremas. - Remova metadados EXIF da imagem
Algumas imagens contêm metadados corrompidos ou não suportados que confundem o ImageMagick. Use uma ferramenta gratuita como ExifTool ou um removedor de EXIF online para remover todos os metadados da imagem antes de enviar. Este passo é opcional, mas ajuda se os passos anteriores não resolverem o erro. - Envie a imagem corrigida
Vá em Preferências > Perfil > Avatar. Clique no botão Procurar e selecione sua imagem corrigida. Clique em Salvar alterações. Se o erro ainda aparecer, a imagem ainda pode estar muito grande ou em um formato não suportado. Repita os passos 1 a 3 com uma imagem menor ou mais simples.
Se a Imagem do Avatar Ainda Falhar ao Processar
Imagem Contém um Perfil de Cor Não Suportado
Imagens editadas em softwares profissionais como Adobe Photoshop às vezes incorporam perfis de cor CMYK ou ProPhoto RGB. O Mastodon espera perfis de cor sRGB. Para corrigir isso, abra a imagem no Paint, que converte automaticamente para sRGB ao salvar. Salve novamente a imagem como PNG ou JPEG usando o Paint e tente enviar novamente.
Cache do Navegador Interferindo no Upload
Um cache de navegador desatualizado pode fazer a interface web do Mastodon exibir o avatar antigo enquanto mostra um erro de processamento. Limpe o cache e os cookies do seu navegador e recarregue a página do Mastodon. Alternativamente, tente enviar o avatar usando uma janela privada ou anônima do navegador. Se o upload funcionar lá, o problema estava relacionado ao cache.
Problema com a Versão do ImageMagick no Servidor
Se você é administrador de uma instância do Mastodon e usuários relatam esse erro com frequência, a versão do ImageMagick no servidor pode estar desatualizada ou mal configurada. Verifique os logs do servidor em busca de mensagens de erro do ImageMagick. Atualizar o ImageMagick para a versão 7 ou superior geralmente resolve falhas de processamento. Essa causa é rara para usuários comuns em uma instância bem mantida.
| Item | Formato ou Valor Aceito | Formato ou Valor Rejeitado |
|---|---|---|
| Formato do arquivo | PNG, GIF, JPG, JPEG, WebP | BMP, TIFF, SVG, HEIC, ICO |
| Tamanho máximo do arquivo | 2 MB ou menor | Maior que 2 MB |
| Dimensões da imagem | Proporção quadrada, pelo menos 336×336 px | Proporção não quadrada ou menor que 336 px |
| Perfil de cor | sRGB | CMYK, ProPhoto RGB, Adobe RGB |
A tabela acima resume os limites técnicos exatos que o Mastodon impõe durante o processamento do avatar. Atender a todos os quatro critérios garante um upload bem-sucedido. Se você ainda vir o erro após seguir todos os passos, entre em contato com o administrador da sua instância para verificar a configuração do servidor.
Após enviar com sucesso um avatar compatível, a nova imagem aparece imediatamente na sua página de perfil para outros usuários verem. Tente enviar um arquivo PNG simples de 336×336 pixels como teste para confirmar que o pipeline de upload funciona. Para uploads futuros, mantenha uma imagem quadrada, sRGB e abaixo de 2 MB pronta no seu computador para evitar solução de problemas repetida.