Email de Notificação de Migração do Mastodon Não Enviado: Causas

Ao mover sua conta do Mastodon de uma instância para outra, a plataforma deve enviar emails de notificação para seus seguidores na instância antiga. Muitos usuários relatam que esses emails nunca chegam. A causa raiz geralmente é uma configuração incorreta no sistema de entrega de email da instância antiga ou uma etapa de verificação ausente durante o processo de migração. Este artigo explica por que o Mastodon falha ao enviar emails de notificação de migração e como identificar e resolver os problemas subjacentes.

Por que o Mastodon Falha ao Enviar Emails de Notificação de Migração

O Mastodon usa um sistema de tarefas em segundo plano para enviar emails quando um usuário inicia uma migração de conta. Quando você inicia a migração da sua conta antiga, o Mastodon enfileira uma tarefa que envia emails de notificação para seus seguidores. Se a entrega do email falhar, a tarefa tenta novamente várias vezes antes de desistir. As razões mais comuns para falha estão relacionadas à configuração do servidor de email, verificação ausente ou problemas de bloqueio de banco de dados.

Problemas de Configuração do Servidor de Email

O Mastodon depende de um servidor SMTP para enviar emails. As configurações SMTP são armazenadas no arquivo .env.production no servidor. Configurações incorretas comuns incluem hostname SMTP incorreto, número de porta errado, credenciais de autenticação ausentes ou domínio do remetente não verificado. Se o servidor SMTP rejeitar a conexão, o Mastodon não conseguirá entregar o email de notificação de migração. Verifique os logs do servidor Mastodon em busca de entradas como Net::SMTPAuthenticationError ou Net::SMTPFatalError para identificar problemas SMTP.

Verificação de Email Ausente na Nova Conta

O Mastodon exige que a nova conta tenha um email verificado antes que o processo de migração possa prosseguir. Se você criou a nova conta, mas não clicou no link de verificação enviado para seu email, o Mastodon não enviará notificações de migração. O sistema trata a nova conta como não verificada e bloqueia a fila de email para essa conta. Verifique o email da sua nova conta acessando sua caixa de entrada em busca de uma mensagem da nova instância. Se você não vir o email de verificação, solicite um novo nas configurações da instância.

Bloqueio de Banco de Dados ou Acúmulo de Filas de Tarefas

O Mastodon usa o Sidekiq para processar tarefas em segundo plano, incluindo entrega de email. Se a fila do Sidekiq estiver acumulada ou uma tarefa falhar devido a um bloqueio de banco de dados, o email de notificação de migração pode nunca ser enviado. Instâncias grandes com muitos usuários ativos podem sofrer atrasos no Sidekiq. Verifique o painel do Sidekiq em /sidekiq na sua instância para ver se a tarefa de email está travada ou falhou. Reiniciar o Sidekiq ou limpar a fila pode resolver esse problema.

Passos para Diagnosticar e Corrigir a Entrega de Email de Migração

Siga estes passos para identificar a causa da falta de emails de notificação e resolver o problema.

1. Verifique o status de verificação de email da nova conta
   Faça login na sua nova conta do Mastodon. Vá em Preferências > Conta. Procure por um banner que diga que seu email não está verificado. Se presente, clique no link para reenviar o email de verificação. Abra o email e clique no link de confirmação. Aguarde 5 minutos e verifique sua conta antiga para ver se o email de migração foi enviado.
2. Revise a configuração SMTP na instância antiga
   Se você é administrador da instância, abra o arquivo .env.production localizado no diretório do Mastodon. Verifique as configurações SMTP: SMTP_SERVER, SMTP_PORT, SMTP_LOGIN, SMTP_PASSWORD e SMTP_FROM_ADDRESS. Certifique-se de que a porta corresponde ao seu provedor SMTP (587 para STARTTLS, 465 para SSL/TLS). Teste a conexão SMTP executando rails runner 'UserMailer.test_email("you@example.com").deliver_now' no console Rails do Mastodon.
3. Verifique o status das tarefas do Sidekiq
   Acesse a interface web do Sidekiq em https://sua-instancia.exemplo/sidekiq. Procure por tarefas com falha nas abas Retries ou Dead. Pesquise por tarefas com a classe NotificationMailer ou AccountMigrationMailer. Se você vir tarefas com falha, clique na tarefa para ver a mensagem de erro. Erros comuns incluem Net::OpenTimeout (servidor SMTP inacessível) ou ActiveRecord::RecordNotFound (conta excluída).
4. Reinicie o Sidekiq e limpe a fila
   Conecte-se via SSH ao seu servidor Mastodon. Execute sudo systemctl restart mastodon-sidekiq para reiniciar o serviço Sidekiq. Se a fila estiver travada, limpe-a executando sudo -u mastodon bash -c 'cd /home/mastodon/live && RAILS_ENV=production bundle exec sidekiqctl stop' seguido de uma reinicialização. Isso força o Mastodon a reprocessar tarefas de email pendentes.
5. Dispare manualmente o email de migração
   Se o email automático falhar, você pode enviá-lo manualmente pelo console Rails do Mastodon. Execute sudo -u mastodon bash -c 'cd /home/mastodon/live && RAILS_ENV=production bundle exec rails c'. Em seguida, execute old_account = Account.find_local('old_username@old_instance.social'); new_account = Account.find_local('new_username@new_instance.social'); AccountMigration.new(old_account, new_account).perform!. Isso ignora a fila e envia a notificação imediatamente.

Se o Mastodon Ainda Tiver Problemas Após a Correção Principal

Email de Migração Marcado como Spam pelos Provedores de Email

Alguns provedores de email como Gmail ou Outlook podem marcar a notificação de migração do Mastodon como spam. Isso acontece quando o domínio de envio da instância não possui registros SPF, DKIM ou DMARC adequados. Peça aos seus seguidores para verificar suas pastas de spam ou lixo eletrônico. Como administrador da instância, adicione registros SPF e DKIM às configurações de DNS do seu domínio para melhorar a entregabilidade. Use uma ferramenta como MXToolbox para verificar seus registros DNS.

Seguidores em Instâncias Remotas Não Recebem o Email

O Mastodon envia emails de notificação de migração apenas para seguidores na mesma instância da conta antiga. Seguidores em outras instâncias recebem uma notificação através do protocolo ActivityPub, em vez de email. Se sua instância antiga tem poucos seguidores locais, a notificação por email parecerá ausente porque nunca foi enviada para usuários remotos. Verifique o número de seguidores locais da instância antiga em Preferências > Conta > Seguidores e seguindo.

Tarefa de Email Travada em Loop Sem Erro

Em casos raros, a tarefa do Sidekiq para o email de migração entra em um loop infinito de tentativas sem registrar um erro. Isso ocorre quando a tarefa encontra um problema de rede transitório. Reiniciar o Sidekiq conforme descrito no Passo 4 geralmente interrompe o loop. Se o problema persistir, exclua a tarefa de migração antiga da fila do Sidekiq e inicie a migração novamente a partir das configurações da conta antiga.

Entrega de Email de Migração do Mastodon: Instância Auto-hospedada vs Gerenciada

Item	Instância Auto-hospedada	Instância Gerenciada
Controle do servidor de email	Controle total sobre as configurações SMTP no .env.production	Depende da configuração de email do administrador da instância
Ponto de falha comum	Host SMTP, porta ou credenciais mal configurados	Administrador da instância desativou o email de saída
Acesso para diagnóstico	SSH e console Rails disponíveis para o administrador	Limitado à interface web; deve contatar o suporte
Entregabilidade de email	Administrador deve configurar SPF, DKIM, DMARC	Provedor gerenciado cuida dos registros DNS
Tempo de recuperação	Minutos a horas, dependendo da experiência do administrador	Horas a dias, dependendo da fila de suporte

Entender essas diferenças ajuda você a escolher o caminho de solução de problemas adequado. Usuários de instâncias auto-hospedadas podem editar diretamente os arquivos de configuração. Usuários de instâncias gerenciadas devem enviar um ticket de suporte ao administrador da instância. Em ambos os casos, verificar o email da nova conta e analisar os logs do Sidekiq são os primeiros passos.