Mastodon ‘Could Not Find User’ em um Handle Válido: Correção

Quando você digita um handle válido do Mastodon como @user@instance.social na barra de pesquisa e vê o erro Could not find user, a conta existe mas sua instância não consegue alcançá-la. Este erro aparece mesmo quando o handle está escrito corretamente e a conta existe em outro servidor. A causa é quase sempre um bloqueio de federação, um timeout de rede temporário ou um registro WebFinger ausente na instância remota. Este artigo explica por que o erro ocorre e fornece correções passo a passo para resolvê-lo tanto do lado do usuário quanto do administrador da instância.

Por que o Mastodon Não Consegue Encontrar um Handle de Usuário Válido

O Mastodon usa o protocolo WebFinger para resolver um handle como @user@example.social em uma URL de conta real. Quando você pesquisa um handle, sua instância envia uma requisição para https://example.social/.well-known/webfinger?resource=acct:user@example.social. O servidor remoto deve retornar uma resposta JSON contendo o ID do actor ActivityPub da conta. Se qualquer etapa desta cadeia falhar, o Mastodon mostra o erro Could not find user.

As causas mais comuns são:

• Bloqueio de federação na sua instância: Seu administrador adicionou o domínio remoto a uma lista de bloqueio, impedindo qualquer comunicação.
• Sobrecarga ou timeout do servidor remoto: A instância remota pode estar sob carga ou temporariamente inacessível, fazendo com que a requisição WebFinger expire.
• Resposta WebFinger ausente ou malformada: O servidor remoto pode não suportar WebFinger, pode ter um proxy reverso mal configurado ou pode retornar um erro HTTP (404, 500).
• Limitação do escopo de pesquisa: O Mastodon, por padrão, pesquisa apenas usuários locais e usuários remotos em cache. Handles de contas remotas não armazenadas em cache podem não ser resolvidos a menos que você ative a pesquisa em toda a rede.
• Erro no formato do handle: O handle deve usar o formato completo @username@domain. Omitir o domínio ou usar o prefixo de domínio errado faz com que a busca falhe.

Passos para Corrigir o Erro Could Not Find User

Siga estes passos em ordem. Cada passo resolve uma causa específica do erro. Se um passo não resolver o problema, prossiga para o próximo.

1. Ativar pesquisa em toda a rede conhecida
   Vá em Preferências > Pesquisa. Ative a opção Pesquisar toda a rede conhecida. Isso instrui sua instância a consultar ativamente servidores remotos por handles que ainda não estão em cache. Após ativar, tente a pesquisa novamente. Se o handle for resolvido, o problema era o escopo de pesquisa local padrão.
2. Verificar o formato do handle e o domínio
   Confirme que o handle usa o formato exato @username@domain.tld. Por exemplo, @gargron@mastodon.social. Não inclua espaços extras ou caracteres. Verifique a ortografia do domínio — um erro de digitação como mastodon.socia em vez de mastodon.social causará o erro. Se a conta estiver em um domínio personalizado, certifique-se de que o domínio serve Mastodon ou um servidor ActivityPub compatível.
3. Testar o endpoint WebFinger manualmente
   Abra uma nova aba do navegador e digite: https://domain.tld/.well-known/webfinger?resource=acct:username@domain.tld. Substitua domain.tld e username pelos detalhes da conta remota. Se a página retornar um objeto JSON com um campo subject, o endpoint WebFinger funciona. Se a página mostrar um 404, 500 ou resposta em branco, a instância remota tem um problema de configuração que apenas o administrador dela pode corrigir.
4. Verificar a lista de bloqueio de federação da sua instância
   Se você é o administrador da instância, vá em Administração > Federação > Bloqueios de domínio. Procure pelo domínio remoto na lista. Se aparecer com uma severidade de Suspender ou Silenciar, sua instância não buscará nenhum dado daquele servidor. Remova o bloqueio ou altere a severidade para Nenhum para permitir a busca. Se você não é administrador, entre em contato com o administrador da sua instância e peça para verificar a lista de bloqueio de domínios.
5. Usar a URL completa do perfil do usuário remoto em vez do handle
   Em vez de pesquisar pelo handle, cole a URL completa do perfil do usuário remoto na barra de pesquisa do Mastodon. Por exemplo: https://mastodon.social/@gargron. O Mastodon muitas vezes consegue resolver a conta a partir da URL mesmo quando a busca pelo handle falha, porque a URL referencia diretamente o ID do actor ActivityPub do usuário.
6. Aguardar e tentar novamente após a carga do servidor diminuir
   Se a instância remota estiver enfrentando alto tráfego ou uma interrupção temporária, a requisição WebFinger pode expirar. Aguarde de 15 a 30 minutos e tente a pesquisa novamente. Você pode verificar o status da instância remota usando um serviço como updown.io para confirmar se está online.

Se o Mastodon Ainda Não Consegue Encontrar o Usuário Após a Correção Principal

Handle de usuário resolve em uma instância mas não em outra

Isso indica um bloqueio de federação ou diferença de configuração entre instâncias. Peça ao administrador da instância onde a busca falha para verificar a lista de bloqueio de domínios e a configuração de Authorized Fetch. Se o Authorized Fetch estiver ativado, alguns servidores remotos podem rejeitar a requisição se sua instância não estiver na lista de permissões deles.

WebFinger retorna erro 404 para uma conta válida

A instância remota pode estar executando uma versão do software que não suporta WebFinger ou ter um proxy reverso mal configurado (nginx, Apache, Caddy). O administrador remoto deve verificar se o servidor atende a /.well-known/webfinger e se o caminho não está bloqueado por um firewall ou regra de proxy. O administrador pode testar o endpoint usando curl -i https://domain.tld/.well-known/webfinger?resource=acct:user@domain.tld na linha de comando.

Opção de pesquisar toda a rede conhecida não aparece

A opção Pesquisar toda a rede conhecida está disponível apenas na versão 3.5.0 ou superior do Mastodon. Se você estiver em uma versão mais antiga, a opção não existe. Atualize sua instância do Mastodon para a versão estável mais recente para obter este recurso. Se você estiver em uma instância gerenciada (mastodon.social, mastodon.online), o administrador controla a versão e deve realizar a atualização.

Item	Pesquisa de Handle com Alternância de Rede Completa Desligada	Pesquisa de Handle com Alternância de Rede Completa Ligada
Escopo da pesquisa	Apenas usuários locais e usuários remotos em cache	Todas as instâncias federadas conhecidas via WebFinger
Velocidade da busca	Instantânea para handles em cache	Pode levar de 3 a 10 segundos dependendo da resposta do servidor remoto
Requer WebFinger no remoto	Não, apenas dados em cache	Sim, o remoto deve fornecer WebFinger válido
Funciona em domínios bloqueados	Não	Não

Esta tabela mostra que a alternância de pesquisa em toda a rede expande o escopo da busca, mas não contorna bloqueios de federação ou endpoints WebFinger ausentes. Ambas as opções falham se o servidor remoto estiver bloqueado ou mal configurado.

Após seguir os passos acima, você agora pode resolver o erro Could not find user ativando a pesquisa em toda a rede, verificando o endpoint WebFinger e checando os bloqueios de federação. Se o problema persistir, forneça ao administrador da sua instância a mensagem de erro exata e o handle remoto. O administrador pode verificar os logs do servidor para falhas na requisição WebFinger. Como dica avançada, administradores podem testar a saúde da federação usando o comando tootctl accounts caches para inspecionar contas remotas em cache e forçar uma atualização dos dados de um usuário específico.