Migração Next.js / Astro em Hamburgo

Uma empresa em Hamburgo que muda o site de WordPress, Joomla, Drupal ou de uma framework antiga para Astro ou Next.js ganha ou perde tráfego em função de um detalhe: o que acontece a cada URL antiga no dia do corte. Esta página descreve o trabalho técnico que faço, o que muda por vender a um mercado alemão e o que verifico antes e depois do lançamento.

#O que vale a pena saber sobre o mercado de Hamburgo antes de migrar?

Hamburgo tinha 1 973 896 habitantes a 31 de dezembro de 2024, segundo a Wikipédia, e é a segunda maior cidade da Alemanha. O porto é o maior do país e o terceiro da Europa, atrás de Roterdão e Antuérpia. A mesma fonte indica sediadas na cidade empresas de media como a NDR, o Der Spiegel e o Die Zeit, e presenças relevantes da Airbus e da Lufthansa Technik.

Para um site, isto traduz-se em requisitos práticos: o público compra e pesquisa em alemão, os sites de media vivem de volume de páginas e arquivo. Quem escreve a partir de Portugal para este mercado deve tratar o alemão como língua do conteúdo, não como tradução de última hora.

#Como mapeio os URLs antigos para os novos sem perder posições?

O trabalho começa com um inventário completo dos URLs que existem hoje, e não apenas os do menu. Junto três fontes: o sitemap do CMS, o relatório de páginas do Search Console e um rastreio do próprio site. As páginas que recebem ligações externas ou cliques entram numa lista prioritária.

Depois construo o mapa de redirecionamentos 301, uma linha por URL antigo, com o destino novo decidido por escrito. Regras que aplico:

• Cada URL antigo com valor aponta para a página equivalente, nunca para a página inicial.
• Cadeias de redirecionamentos são colapsadas: o antigo aponta diretamente para o final.
• Parâmetros e variantes (barra final, maiúsculas, ?page=2, index.php) são tratados explicitamente.
• Páginas sem equivalente devolvem 410 ou ficam num arquivo, e a decisão fica registada.

Num alojamento como a Cloudflare Pages, o ficheiro _redirects tem um limite de entradas. Num site grande, o mapa divide-se entre regras por padrão e redirecionamentos por ficheiro, e eu confirmo o limite da plataforma antes de prometer um 1:1.

#O que passa para o modelo de conteúdo e para os dados estruturados?

Em Astro, o conteúdo vive em coleções com esquema validado (Markdown, MDX ou um CMS headless). Cada campo que hoje existe no WordPress, como título, descrição, data, autor, categorias e imagem de destaque, tem de ter um destino. Campos personalizados do ACF ou taxonomias próprias são a parte que mais falha numa migração apressada, por isso exporto-os e comparo contagens: número de entradas por tipo no CMS antigo contra o número de páginas geradas.

Os dados estruturados (JSON-LD) são regenerados a partir do conteúdo e não copiados à mão. Valido uma amostra por tipo de página com o teste de resultados multimédia do Google e com o validador do schema.org, e comparo o canonical e o mainEntityOfPage em cada página. Se o site tem versões em alemão e noutras línguas, o hreflang tem de ser recíproco: se a página alemã aponta para a inglesa, a inglesa aponta de volta.

#Astro ou Next.js para um site em Hamburgo?

Astro para sites com muito conteúdo (institucionais, blogues, documentação, catálogos), porque envia JavaScript apenas onde pedido. Next.js quando existe uma área autenticada, preços dinâmicos ou renderização no servidor ligada a sistemas internos. Registo a recomendação por escrito, com o motivo, para poder ser revista um ano depois sem depender de memória.

#Que regras alemãs afetam um site novo?

Estas são as que verifico, todas lidas nas fontes oficiais.

Cookies e rastreio. O § 25 do TDDDG, publicado em gesetze-im-internet.de, proíbe guardar ou ler informação no equipamento do utilizador sem consentimento baseado em informação clara e completa, e remete o consentimento para o RGPD. Há exceções, como quando o armazenamento é estritamente necessário para prestar o serviço que o utilizador pediu. Na prática, num site novo, analítica, pixéis e vídeos incorporados só carregam depois do consentimento, e eu testo isto no navegador, com a rede aberta, antes do lançamento. Em Hamburgo, a autoridade de proteção de dados é a HmbBfDI (Hamburgische Beauftragte für Datenschutz und Informationsfreiheit), que no seu site disponibiliza formulário de reclamação e de notificação de violações.

Acessibilidade. A BFSG, lei alemã que transpõe a Diretiva (UE) 2019/882, abrange no § 1, n.º 3, ponto 5, os serviços de comércio eletrónico, e aplica-se a esses serviços prestados a consumidores depois de 28 de junho de 2025. Se vende a consumidores na Alemanha, confirme o enquadramento com um jurista. Do lado técnico, o novo frontend leva semântica HTML correta, contraste, navegação por teclado e rótulos de formulários, verificados com um leitor de ecrã e uma ferramenta automática.

#Como faço o corte e o que verifico depois?

1. Ambiente de teste com o mapa 301 e paridade de metadados (title, description, canonical, robots) comparada com o site antigo por rastreio.
2. Ensaio do corte: um script percorre todos os URLs antigos e confirma o código de resposta e o destino final.
3. Corte por secções em sites grandes; num site pequeno, num único dia de baixo tráfego.
4. Submissão do novo sitemap no Search Console e verificação do robots.txt, para que o ambiente de teste nunca fique indexado nem o site real fique bloqueado por engano.
5. Nas semanas seguintes, leio os relatórios de cobertura, os erros 404 e os Core Web Vitals, e corrijo as quedas de indexação antes de uma campanha perder tráfego.

O que pode correr mal, e como o apanho: redirecionamentos para a página inicial (aparecem como soft 404 no Search Console), noindex herdado do ambiente de teste (rastreio pós-lançamento), imagens com caminhos novos (comparo o rastreio de imagens), formulários que deixam de enviar (teste de envio real).

Mais detalhe do método geral está em migração para Astro e Next.js. Se o site é uma loja, veja também migração de WooCommerce para headless.

#Um site migrado perde posições no Google?

Pode perder, se os URLs mudarem sem mapa de redirecionamentos. Por isso o 301 um para um e a paridade de metadados vêm antes de qualquer decisão visual. Depois do corte, acompanho o Search Console até as páginas principais estabilizarem.

#Preciso de um site em alemão para vender em Hamburgo?

O alemão é a língua corrente da cidade, segundo a Wikipédia. Um site só em português ou inglês chega a menos compradores. Se o conteúdo existe em várias línguas, uso hreflang recíproco para que cada versão apareça no mercado certo.

#O banner de cookies muda com Astro ou Next.js?

A obrigação não muda: o § 25 do TDDDG continua a exigir consentimento para o que não é estritamente necessário. Muda a implementação, que passa a ser explícita no código, em vez de depender de plugins.

#Como começo?

Envie-me o URL atual, o CMS e as principais fontes de tráfego. Respondo com um âmbito escrito e os riscos que vejo no mapa de URLs.