Hashtag do Mastodon não aparece na busca: como corrigir

Você criou uma hashtag no Mastodon e esperava que ela aparecesse nos resultados de busca, mas ela não mostra nenhuma publicação ou simplesmente não aparece. Isso acontece porque o mecanismo de busca do Mastodon indexa o conteúdo de forma diferente das redes sociais tradicionais. O Mastodon não indexa automaticamente toda publicação com hashtag — o servidor precisa primeiro processar e armazenar em cache os dados da tag. Este artigo explica por que uma hashtag não aparece na busca e fornece instruções passo a passo para corrigir o problema.

Por que as hashtags do Mastodon não aparecem nos resultados de busca

O Mastodon usa um mecanismo de busca chamado Elasticsearch para indexar publicações, perfis e hashtags. Por padrão, as instâncias do Mastodon não habilitam a busca textual completa. Quando a busca textual completa está desabilitada, a função de busca só consegue corresponder nomes de conta exatos ou IDs de publicação, não o texto da hashtag dentro de uma publicação. Mesmo quando a busca textual completa está habilitada, o processo de indexação é executado em um cronograma, geralmente a cada poucas horas. Uma hashtag que você acabou de criar pode não ficar visível nos resultados de busca até que o próximo ciclo de indexação seja concluído.

Outra causa comum é que o administrador da instância não configurou o Elasticsearch corretamente. Sem uma conexão funcional entre o Mastodon e o Elasticsearch, nenhuma hashtag será indexada. Por fim, se sua publicação for de um servidor federado que não está totalmente sincronizado com sua instância, a hashtag pode existir no servidor remoto, mas não ser pesquisável localmente.

Passos para corrigir uma hashtag ausente do Mastodon na busca

Siga estes passos em ordem. Comece com as verificações mais simples e vá para correções no nível do servidor apenas se necessário.

1. Aguarde 24 horas para indexação automática
   As instâncias do Mastodon geralmente reindexam o conteúdo a cada 6 a 24 horas. Se você publicou uma hashtag há menos de um dia, aguarde e verifique novamente após 24 horas. Este é o motivo mais comum para uma hashtag ausente.
2. Pesquise pela hashtag exata incluindo o símbolo de hash
   Na barra de busca do Mastodon, digite a hashtag exatamente como você a publicou, incluindo o símbolo #. Por exemplo, digite #projeto em vez de apenas projeto. O Mastodon trata essas consultas de forma diferente.
3. Certifique-se de que a publicação seja pública e não listada como não listada
   Apenas publicações públicas são indexadas para busca. Se a visibilidade da sua publicação estiver definida como Não listada, Seguidores ou Direta, a hashtag não aparecerá nos resultados de busca para outros usuários. Altere a visibilidade da publicação para Pública antes de publicar com uma hashtag.
4. Verifique se a busca textual completa está ativada em sua instância
   Abra a interface web do Mastodon e clique na barra de busca. Se você vir uma mensagem como “A busca textual completa não está ativada neste servidor”, o administrador da instância precisa ativá-la. Entre em contato com o administrador do servidor ou verifique as configurações da instância. A busca textual completa é controlada pela variável de ambiente FULL_TEXT_SEARCH definida como true na configuração do Mastodon.
5. Force uma reindexação manual a partir do terminal do servidor
   Se você é o administrador da instância, conecte-se via SSH ao servidor e execute o seguinte comando: tootctl search deploy. Este comando aciona uma reindexação completa de todas as publicações, perfis e hashtags. O processo pode levar vários minutos, dependendo do tamanho do banco de dados. Após a conclusão do comando, verifique os resultados da busca novamente.
6. Verifique se o Elasticsearch está em execução e conectado
   Execute curl http://localhost:9200 no terminal do servidor. Se o Elasticsearch estiver em execução, você verá uma resposta JSON com status 200. Se a conexão falhar, reinicie o Elasticsearch com sudo systemctl restart elasticsearch e execute tootctl search deploy novamente.

Se a hashtag ainda não aparecer após esses passos

Hashtag mostra zero publicações mesmo quando existem publicações

Isso geralmente significa que o índice está corrompido ou desatualizado. Execute tootctl search deploy --clean para reconstruir o índice do zero. A flag --clean remove o índice antigo antes de criar um novo. Isso pode levar mais tempo, mas resolve a maioria dos problemas de corrupção.

Hashtag aparece na busca na instância local, mas não em instâncias remotas

Atrasos de federação podem causar isso. Instâncias remotas podem ainda não ter recebido a publicação. Verifique a busca da instância remota após 48 horas. Se ainda não aparecer, a instância remota pode ter desabilitado a busca textual completa ou estar bloqueando sua instância.

Hashtag contém caracteres especiais ou espaços

As hashtags do Mastodon só podem conter letras, números e underscores. Espaços, hífens e pontuação quebram a tag. Se sua hashtag incluir um espaço, o Mastodon trata apenas a primeira palavra como a tag. Remova quaisquer caracteres especiais e publique novamente.

Busca textual completa do Mastodon vs. busca básica: comportamento de indexação

Item	Busca textual completa ativada	Busca básica (padrão)
Indexação de hashtag	Indexada a partir do texto do corpo da publicação	Não indexada a partir do corpo da publicação
Conteúdo pesquisável	Texto da publicação, hashtags, nomes de conta	Apenas nomes de conta e IDs de publicação
Frequência de atualização do índice	A cada 6–24 horas ou por comando manual	Tempo real apenas para nomes de conta
Uso de recursos do servidor	Maior uso de CPU e memória para Elasticsearch	Mínimo
Variável de configuração	FULL_TEXT_SEARCH=true	FULL_TEXT_SEARCH=false (padrão)

Agora você pode diagnosticar e corrigir uma hashtag ausente do Mastodon nos resultados de busca. Comece aguardando a indexação automática e verificando a visibilidade da publicação. Se o problema persistir, entre em contato com o administrador da instância para ativar a busca textual completa ou execute o comando tootctl search deploy. Para corrupção persistente do índice, use a flag --clean para reconstruir o índice do zero. Sempre use visibilidade pública para hashtags que você deseja que outros descubram.