Como corrigir o erro ‘Lookup Failed’ no Mastodon ao pesquisar usuários
🔍 WiseChecker

Como corrigir o erro ‘Lookup Failed’ no Mastodon ao pesquisar usuários

Quando você pesquisa um usuário no Mastodon pelo handle completo, pode ver a mensagem de erro “Lookup Failed” em vez dos resultados esperados. Isso acontece porque o Mastodon busca na rede federada de instâncias, e a solicitação pode falhar devido a problemas de conectividade, bloqueios de instância ou formatação incorreta do handle. Este artigo explica por que a busca falha e fornece correções passo a passo que você pode aplicar na interface web ou no aplicativo móvel do Mastodon.

O erro não é um bloqueio permanente. Geralmente, ele é resolvido após verificar o formato do handle, reiniciar o cliente ou confirmar que a instância remota está acessível. Você também pode usar métodos alternativos de busca para encontrar o usuário sem acionar o mesmo erro.

Siga as instruções abaixo para eliminar as causas mais comuns do erro de busca e restaurar sua capacidade de encontrar e seguir usuários na rede Mastodon.

Principais conclusões: corrigindo o erro Lookup Failed no Mastodon

  • Formato do handle @usuario@instancia.exemplo: Sempre inclua o nome de usuário e o domínio completo da instância remota ao pesquisar.
  • Caixa de busca no Mastodon web ou app: Digite o handle completo e pressione Enter, depois aguarde a conclusão da busca antes de clicar em qualquer resultado.
  • Bloqueio de instância ou pausa na federação: Verifique se sua instância bloqueou a instância remota ou se a instância remota está temporariamente indisponível.

ADVERTISEMENT

Por que o erro Lookup Failed aparece no Mastodon

O Mastodon usa uma arquitetura federada onde cada instância é um servidor separado que se comunica com outros através do protocolo ActivityPub. Quando você insere um handle completo como @usuario@exemplo.social na caixa de busca, sua instância envia uma solicitação para a instância remota pedindo os dados do perfil desse usuário. O erro de busca ocorre quando essa solicitação não retorna uma resposta válida dentro de um tempo razoável.

Causas técnicas comuns

A instância remota pode estar offline, sobrecarregada ou bloqueando solicitações da sua instância. Sua própria instância também pode ter um problema de rede temporário que a impede de alcançar o servidor remoto. Além disso, se você digitar o handle incorretamente, o Mastodon não consegue resolver o usuário porque a parte do domínio não corresponde a nenhum servidor conhecido.

Bloqueios de instância e moderação

Administradores de instância frequentemente bloqueiam ou limitam a federação com certos servidores. Se sua instância tiver um bloqueio de domínio contra a instância do usuário remoto, a busca falhará silenciosamente. Você pode verificar isso perguntando ao administrador da sua instância ou acessando a página de moderação da instância, se tiver permissão.

Passos para corrigir o erro Lookup Failed no Mastodon

  1. Verifique o formato do handle do usuário
    Certifique-se de estar usando o handle completo no formato @usuario@dominio.tld. Por exemplo, @gargron@mastodon.social. Não use apenas @usuario ou usuario@dominio sem a @ inicial. Cole o handle em um editor de texto primeiro para verificar se há espaços ocultos ou caracteres especiais.
  2. Faça uma nova busca após limpar a caixa de busca
    Clique dentro da caixa de busca do Mastodon, apague qualquer texto existente, digite ou cole o handle completo novamente. Pressione Enter e aguarde pelo menos 10 segundos. Não clique em nenhuma sugestão de autocompletar até que a busca termine. Se o erro persistir, vá para o próximo passo.
  3. Reinicie o cliente Mastodon ou recarregue a página web
    Feche a aba do navegador ou o aplicativo móvel do Mastodon completamente. Reabra o aplicativo e faça login novamente, se necessário. Repita a busca com o mesmo handle. Isso limpa qualquer cache temporário do cliente que possa interferir na busca.
  4. Teste a conectividade com a instância remota
    Abra uma nova aba do navegador e visite a URL pública da instância remota diretamente. Exemplo: se o handle for @usuario@exemplo.social, vá para https://exemplo.social. Se a página carregar, a instância está online. Se houver timeout ou erro, o servidor remoto pode estar fora do ar ou bloqueando seu IP.
  5. Use a interface web do Mastodon em vez de um aplicativo de terceiros
    Clientes Mastodon de terceiros podem ter APIs desatualizadas ou comportamento de busca diferente. Faça login na interface web da sua instância usando um navegador de desktop e repita a busca lá. Se a busca funcionar na interface web, o problema está no seu aplicativo.
  6. Peça ao administrador da sua instância para verificar os logs de federação
    Administradores de instância podem visualizar logs do servidor para entender por que uma busca falhou. Eles podem verificar se a instância remota está bloqueada, se a solicitação expirou ou se o servidor remoto retornou um erro. Entre em contato com seu administrador pelo canal de suporte da instância e forneça o handle exato que você tentou pesquisar.

ADVERTISEMENT

Se o Mastodon ainda mostrar Lookup Failed após a correção principal

Pesquisar um usuário sem o handle completo falha sempre

Se você digitar apenas o nome de usuário sem o domínio, o Mastodon pesquisa apenas sua instância local. Para encontrar um usuário remoto, você deve sempre incluir o handle completo. Se você não souber o domínio exato, tente pesquisar uma postagem desse usuário procurando por uma frase única que ele publicou. Se encontrar a postagem, clique no nome do usuário para visitar o perfil e siga-o a partir de lá.

A busca funciona para algumas instâncias, mas não para outras

Isso indica que sua instância bloqueou ou não está federando com instâncias remotas específicas. Você pode verificar os bloqueios de domínio da sua instância acessando Preferências > Moderação > Bloqueios de Domínio, se for administrador. Se você for um usuário comum, não pode remover esses bloqueios. Entre em contato com seu administrador para solicitar a liberação da federação com a instância bloqueada.

A busca falha apenas no aplicativo móvel, mas funciona na web

Este é um problema conhecido em alguns aplicativos móveis do Mastodon que armazenam resultados de busca em cache ou usam endpoints de API desatualizados. Force o fechamento do aplicativo, limpe o cache nas configurações do dispositivo e reabra. Se o problema persistir, use a interface web no navegador do celular como solução temporária.

Item Interface Web Aplicativo Móvel
Comportamento da busca Busca direta usando ActivityPub Pode usar API em cache ou limitada
Limpeza de cache Cache do navegador ou modo anônimo Cache do app ou reinstalação
Exigência do handle @usuario@dominio completo obrigatório Mesma exigência

O erro de busca no Mastodon é quase sempre causado por um problema de rede ou formatação que você pode corrigir seguindo os passos acima. Após verificar o formato do handle e a disponibilidade da instância remota, você deve conseguir pesquisar e seguir usuários no fediverso sem interrupções. Para problemas persistentes, sempre entre em contato com o administrador da sua instância para diagnóstico no servidor.

ADVERTISEMENT