Ao se deparar com o Erro 422 no Mastodon com a mensagem “Falha na Validação,” o servidor rejeitou sua solicitação porque os dados enviados não atendem às regras. Esse erro aparece ao postar, seguir contas ou enviar mídia. O problema geralmente vem de requisições de API malformadas, tokens de sessão expirados ou conteúdo que viola limites da instância. Este artigo explica os motivos técnicos por trás do Erro 422 e fornece etapas claras para resolver cada causa.
Principais Conclusões: Erro 422 “Falha na Validação” no Mastodon
- Preferências > Conta > Aplicativos autorizados: Revogue e adicione novamente aplicativos de terceiros que enviam requisições de API inválidas.
- Saia e entre novamente: Renova o token de sessão e limpa credenciais desatualizadas que causam o erro 422.
- Limite de caracteres da postagem: Certifique-se de que o texto da postagem, incluindo avisos de conteúdo e descrições de mídia, fique abaixo de 500 caracteres.
Por que o Mastodon Retorna um Erro 422 de Falha na Validação
O Mastodon usa o código de status HTTP 422 para indicar que o servidor entende sua solicitação, mas não pode processá-la porque os dados são inválidos. Isso não é uma falha no servidor ou um problema de rede. O servidor rejeita especificamente o payload enviado.
Os gatilhos mais comuns incluem:
Formato de Requisição de API Inválido
Aplicativos de terceiros como Tusky, Fedilab ou clientes web enviam requisições com campos ausentes ou formatados incorretamente. Por exemplo, uma solicitação de seguir pode não ter o parâmetro account_id obrigatório. O servidor valida todos os campos obrigatórios e retorna 422 se algum campo estiver faltando ou tiver o tipo de dado errado.
Tokens de Sessão Expirados ou Corrompidos
Toda requisição autenticada inclui um token de sessão armazenado no navegador ou aplicativo. Se esse token ficar desatualizado, corrompido ou revogado, o servidor não consegue verificar sua identidade. Ele então rejeita a ação com um erro 422 em vez do esperado 401 Não Autorizado.
Conteúdo que Viola as Regras da Instância
Cada instância do Mastodon define seus próprios limites de tamanho de postagem, mídia e tipos de arquivo. Se você tentar postar um texto com mais de 500 caracteres em uma instância padrão, ou enviar um vídeo maior que 40 MB, a validação do servidor falha. A mensagem de erro pode não especificar o limite.
Passos para Resolver Cada Causa do Erro 422
- Atualize a página ou reinicie o aplicativo
Problemas temporários na interface web ou no aplicativo móvel podem causar requisições malformadas. Feche a aba do navegador ou o aplicativo completamente e reabra. Tente a mesma ação novamente. Se o erro desaparecer, a causa foi um soluço temporário de sessão. - Saia e entre novamente na sua conta
Vá em Preferências > Conta > Sair. Após sair, feche o navegador ou aplicativo. Faça login novamente com suas credenciais. Isso substitui o token de sessão por um novo. Teste a ação que falhou anteriormente. - Verifique o tamanho da postagem e anexos de mídia
Conte os caracteres da sua postagem, incluindo o texto do aviso de conteúdo e descrições de mídia. Instâncias padrão do Mastodon permitem até 500 caracteres. Se você usa uma instância personalizada, verifique a página de regras da instância. Reduza o tamanho da postagem ou divida-a em várias postagens. Para mídia, verifique se as imagens têm menos de 10 MB e os vídeos menos de 40 MB. Use JPEG, PNG, GIF ou WebP para imagens e MP4 ou WebM para vídeos. - Revogue e reautorize aplicativos de terceiros
Se você usa um cliente de terceiros como Tusky ou Fedilab, vá em Preferências > Conta > Aplicativos autorizados. Encontre o aplicativo que disparou o erro e clique em Revogar. Depois, faça login novamente através desse aplicativo. Isso garante que o aplicativo use um token de API válido com as permissões corretas. - Limpe o cache e cookies do navegador
Nas configurações do navegador, limpe os dados em cache e cookies para o domínio do Mastodon. No Chrome, vá em Configurações > Privacidade e segurança > Limpar dados de navegação. Selecione Cookies e outros dados do site e Imagens e arquivos em cache. Clique em Limpar dados. Recarregue o Mastodon e tente novamente. - Tente um navegador ou dispositivo diferente
Se o erro persistir em um navegador, mude para outro como Firefox, Edge ou Safari. Se você usa um aplicativo móvel, tente a interface web. Isso ajuda a isolar se o problema é específico do seu cliente atual.
O que Fazer se o Erro 422 no Mastodon Ainda Aparecer
Erro 422 ao Seguir um Usuário
Se você receber um erro 422 ao tentar seguir alguém, a conta alvo pode ter sido suspensa ou excluída. Verifique a página de perfil do usuário diretamente. Se mostrar uma mensagem “Esta conta foi suspensa,” você não pode segui-la. Se a conta existir, tente seguir a partir de um cliente diferente ou da interface web.
Erro 422 ao Postar com Hashtags
Algumas instâncias restringem o número de hashtags por postagem. Se sua postagem incluir mais de dez hashtags, reduza o número para cinco ou menos. Certifique-se também de que as hashtags não contenham espaços ou caracteres especiais além de underscores.
Erro 422 ao Enviar uma Foto de Perfil
Fotos de perfil devem ter menos de 2 MB e estar em um formato suportado. Redimensione sua imagem para 400×400 pixels ou menor usando um editor de imagens. Salve como JPEG ou PNG e tente enviar novamente.
Erro 422 no Mastodon vs Outros Erros HTTP
| Item | Erro 422 Falha na Validação | Erro 401 Não Autorizado |
|---|---|---|
| Descrição | Dados da requisição são inválidos ou incompletos | Credenciais de autenticação ausentes ou inválidas |
| Causa comum | Postagem muito longa, campos ausentes, formato de arquivo inválido | Token expirado, sessão encerrada, senha incorreta |
| Solução | Verificar limites de entrada, renovar token, revogar aplicativos | Fazer login novamente, redefinir senha |
Entender a diferença ajuda a aplicar a correção correta mais rapidamente. Um erro 422 significa que o servidor viu suas credenciais, mas rejeitou os dados. Um erro 401 significa que o servidor não reconheceu suas credenciais.
Agora você pode identificar a causa do Erro 422 no Mastodon e aplicar a solução adequada. Comece renovando sua sessão e verificando os limites de postagem. Se o erro persistir, revogue e reautorize aplicativos de terceiros. Para solução de problemas avançada, inspecione o console do desenvolvedor do navegador em busca de mensagens de validação específicas na aba Rede.