JAVASCRIPT SEO
Canonical schimbat după JavaScript hydration: diagnostic și corecție
Serverul declară un URL canonical. JavaScript declară altul. Ce semnal primește Google?
1. Problemă și simptome
Sursa HTML indică o adresă, iar DOM-ul randat indică alta sau conține două elemente canonical. Conflictul poate apărea numai după navigare internă. În Search Console, canonicalul ales de Google poate fi diferit; aceasta este o observație separată, nu dovada că hydration a provocat alegerea.
Înregistrează URL-ul solicitat, URL-ul final, canonicalul declarat și cel ales de Google. Compară aceeași rută la încărcare directă și după un click din aplicație.
2. Răspuns rapid
Păstrează o singură regulă pentru canonical, coerentă între HTML și pagina randată. Elimină efectele React și aplicațiile care schimbă adresa stabilită de server. În Next.js App Router, configurează metadatele în componenta de server și verifică rezultatul real. Retestează încărcarea directă și navigarea internă. Canonicalul este un semnal de preferință; validarea lui nu garantează că Google îl va selecta sau va indexa pagina.
3. Cauze posibile
Caută două componente care gestionează head-ul, un efect bazat pe window.location, un domeniu de staging moștenit sau o regulă greșită de parametri și limbă. Acestea sunt ipoteze; identifică fișierul responsabil înainte de corecție.
Streamingul metadatelor Next.js este un caz distinct: verifică versiunea și comportamentul pentru user-agentul testat. Lipsa canonicalului din primul fragment al răspunsului nu demonstrează o modificare prin hydration. Inspectează răspunsul complet și DOM-ul final.
4. Reproducerea problemei
Descarcă exemplele reproductibile. Dezarhivează și rulează node serve.mjs, apoi folosește comenzile locale de mai jos. Cerință: Node.js 20.9 sau mai nou. Instrucțiunile pentru Next.js și Liquid sunt incluse în arhivă.
Fixture-ul local canonical reproduce o modificare deliberată prin JavaScript. Nu este un incident observat pe site. HTML-ul inițial conține:
<link rel="canonical" href="https://example.test/services/">
Compară înainte și după execuția scripturilor. În consola browserului rulează expresia de mai jos; ea doar citește DOM-ul:
[...document.querySelectorAll('link[rel~="canonical"]')].map(el => ({
raw: el.getAttribute('href'),
resolved: el.href,
inHead: document.head.contains(el)
}));
Într-o aplicație React, acest efect este un exemplu de cod care ar introduce conflictul și trebuie eliminat:
// Anti-pattern: do not keep this effect in the fixed application.
useEffect(() => {
document.querySelector('link[rel="canonical"]')
?.setAttribute('href', 'https://example.test/wrong/');
}, []);5. Flux de diagnostic
- Salvează răspunsul complet prin GET, antetele și redirecturile. Verifică și eventualele antete Link care declară un canonical.
- Numără canonicalurile din document și inspectează poziția lor. Compară valoarea brută cu URL-ul absolut rezolvat.
- Repetă după încărcare directă, navigare internă și schimbarea limbii; include rute dinamice și URL-uri cu parametri.
- Caută în sursă canonical, alternates, Helmet și efecte care schimbă head-ul. Atribuie metadatele unei singure componente.
- În URL Inspection compară declarația și canonicalul ales în datele indexate. Testul live ajută la inspectarea paginii actuale; nu dovedește o nouă alegere a canonicalului în index.
6. Remediere și validare
Pentru Next.js App Router, exemplul de mai jos folosește metadata statică și metadataBase. Nu exporta metadata dintr-o componentă marcată use client. Pentru rute dinamice, generează adresa din datele rutei și politica editorială, nu din starea interfeței.
// app/layout.tsx — Next.js App Router
import type { Metadata } from 'next';
export const metadata: Metadata = {
metadataBase: new URL('https://example.test'),
};
export default function Layout({ children }: { children: React.ReactNode }) {
return <html lang="en"><body>{children}</body></html>;
}
// app/services/page.tsx — Server Component
import type { Metadata } from 'next';
export const metadata: Metadata = {
alternates: { canonical: '/services/' },
};
export default function Services() { return <h1>Services</h1>; }
Păstrează un canonical propriu pentru fiecare traducere și relația de limbă prin hreflang. Aliniază sitemap-ul, redirecturile și linkurile interne la adresele preferate.
Acceptă schimbarea când ruta corectă este declarată o singură dată, rămâne stabilă după navigare și răspunde cu pagina așteptată. Exemplul Next.js este verificat prin build și răspuns HTTP local; nu este o certificare pentru toate versiunile sau configurațiile Next.js.
7. Greșeli frecvente
- Forțezi canonical către homepage pentru toate rutele.
- Elimini automat orice parametru, inclusiv unul care identifică o pagină distinctă.
- Trimiți canonical EN către RO în locul unei relații de traducere.
- Adaugi un al doilea canonical pentru a-l „corecta” pe primul.
- Folosești noindex sau robots.txt ca înlocuitor automat al canonicalului.
8. Surse oficiale și ghiduri conexe
Documentația Google explică semnalele de canonicalizare; documentația Next.js descrie API-ul și streamingul metadatelor. Exemplul React ilustrează mecanismul conflictului. Nu prezentăm date Search Console sau rezultate de client.