SEO troubleshooting: locating and fixing high-frequency failures
The most common production failures for SEO and their root-cause fixes.
Quick answer
How do I keep canonical and sitemap hostnames consistent?
Both must read site.origin (the Astro site config). Hardcoded hostnames break the moment you change domain or run a Preview, and the page gets flagged as duplicate content.
Machine-readable page data: /data/seo-troubleshooting.json
In-depth analysis
SEO is fundamentally about making canonical signals (canonical link, sitemap, structured data) clear and traceable so search engines never classify your pages as duplicates. Troubleshoot by three layers — build, deploy, runtime — diagnose by symptom, never blind-trial.
# public/robots.txt
User-agent: *
Allow: /
Disallow: /links/
Disallow: /api/
Sitemap: https://aicode8.com/sitemap-index.xmlSEO Troubleshooting · Key takeaways
- Build, deploy, or runtime layer identified
- Relevant logs and status codes captured
- Fix verified and reproducible
- Fix notes recorded for reuse
FAQ & pitfalls
How do I fix mass-generated long-tail pages being flagged as duplicates?
Every page needs a unique canonical, an independent title, and differentiated body content. Pages that only swap keywords with identical structure need real differences added or search engines will fold them.
How often does search engine cache refresh?
Bump lastmod to trigger a sitemap re-crawl, paired with an independent canonical. Do not rely on forcing a CDN purge — after the static output updates, crawlers return naturally.
Explore the hub
See all 5 guides in PerformanceSame category as this article, sorted across the codebase.
AI Search troubleshooting: locating and fixing high-frequency failures
The most common production failures for AI Search and their root-cause fixes.
Astro troubleshooting: locating and fixing high-frequency failures
The most common production failures for Astro and their root-cause fixes.
Cloudflare Pages troubleshooting: locating and fixing high-frequency failures
The most common production failures for Cloudflare Pages and their root-cause fixes.
GEO troubleshooting: locating and fixing high-frequency failures
The most common production failures for GEO and their root-cause fixes.
Share & save
What readers are asking
Questions that keep coming back in reader feedback, already answered.
- 01
How do the canonical and sitemap domains stay in sync?
Both must read site.origin (the Astro site setting). A hardcoded domain breaks everywhere the moment you change domains or use a Preview URL, and the pages get treated as duplicates.
See the full guide → - 02
How do I stop generated pages being flagged as duplicate content?
Every page needs a unique canonical, its own title, and genuinely differentiated body copy. Pages that only swap a keyword while keeping an identical structure must gain real differences, or search engines fold them together.
See the full guide → - 03
Why is my Astro component's interactivity not working?
Components ship as zero-JS HTML by default, so an interactive one needs a client:* directive (client:load, client:visible, …). Without it the script is never bundled into the page.
See the full guide →