JavaScript 网站技术 SEO 上线前 QA 检查清单

一个 JavaScript 网站在浏览器里看起来已经完成，但对搜索引擎来说可能还没有完成。问题不是 Google 完全不能渲染 JavaScript，而是渲染、hydration、路由、元数据和客户端内容都会增加出错位置，小问题很容易拖到上线周才暴露。

这份清单适合准备上线 Next.js、React、Headless Commerce，或大量依赖前端应用的网站团队。网站改版、Headless 迁移、从传统模板切换到 JavaScript 前端时，都应该先用它检查一轮。目标很简单：验证搜索引擎和爬虫实际拿到什么，而不只是设计评审看到什么。

先看最重要的页面类型：首页、服务页、分类页、产品页、文章页、落地页，以及多语言模板。每个 URL 都要对比原始源码和 JavaScript 执行后的 DOM。渲染后的版本应该包含这个模板需要排名和理解的主内容、H1、内链、canonical、索引信号和结构化数据。

源码 HTML 很薄不一定马上判定失败。有些架构本来就依赖渲染。但团队必须清楚哪些内容依赖 JavaScript，以及这种依赖对关键页面是否可以接受。

• 同一个 URL 同时查看 view-source 和渲染后的检查结果。
• 确认 H1、核心正文、产品或服务信息、主要内链在渲染后可见。
• 标记那些重要内容只有交互、延迟脚本或个性化逻辑之后才出现的模板。

JavaScript 网站的元数据问题很容易成倍增加，因为路由通常来自 CMS、商品数据或动态页面构建器。上线前，要为每一种页面类型定义规则：title、meta description、canonical URL、robots meta、Open Graph、Twitter card、hreflang 和结构化数据。

然后用真实内容测试这些规则。很长的产品名、空 CMS 字段、重复的服务标题、本地化 slug、未发布记录，都是元数据系统最容易翻车的地方。好的 QA 会在上线前检查 fallback 行为，而不是上线后再补。

• 检查标题长度、重复标题、缺失描述和错误的品牌后缀。
• 确认 canonical 使用最终生产域名和最终斜杠规则。
• 验证 Organization、WebSite、BreadcrumbList、Article、Product、Service 或 FAQ 等 JSON-LD。

视觉 QA 通常能发现坏掉的按钮，但会漏掉爬虫更关心的链接。用支持 JavaScript 渲染的工具抓取 staging，如果工具支持，也分别抓取开启和关闭渲染的版本。对比抓取深度、可索引 URL、重复路径、nofollow 使用，以及返回错误 HTTP 状态的客户端路由。

导航状态也要重点看。Mega menu、筛选器、语言切换、分页、相关文章、面包屑和页脚链接都会帮助搜索引擎理解网站。如果它们只是客户端控件，没有真实 href，网站可能比看起来更难被抓取。

• 重要导航项应该有可抓取的 href，而不只是 onClick。
• 分页、筛选和参数 URL 要有明确的 index/noindex 和 canonical 策略。
• 多语言页面应该链接到对应语言版本，而不是所有 alternate 都指向首页。

上线清单不能只检查页面是否能打开。还要测试搜索引擎用于发现和判断 URL 的文件和响应：XML sitemap 覆盖范围、robots.txt 规则、重定向行为、404 页面、410 决策，以及已删除 URL 是否真的返回预期状态码。

如果是迁移项目，要在发布环境跑一遍重定向表，再宣布上线完成。JavaScript 应用可能显示一个友好的错误页，但服务器仍然返回错误状态；这种不一致正是上线后最常见、也最可以避免的 SEO 清理项。

• 站点地图里只放 canonical、可索引、200 状态的页面。
• 尽量避免重定向链；旧 URL 应该一步跳到最接近的新页面。
• 404 和 410 应返回正确 HTTP 状态，而不是一个写着错误信息的 200 页面。

不要只测首页。JavaScript SEO 风险经常出现在更重的模板里：带评论的产品页、带筛选的分类页、带嵌入内容的文章页、装了多种追踪脚本的落地页，以及带翻译工具或 consent 工具的多语言页面。

可以用 Lighthouse、Chrome DevTools、WebPageTest 或现有监控工具，但测试集要务实。选择代表收入、线索、自然流量和内容运营的页面。记录 Core Web Vitals、阻塞脚本、图片重量、hydration 成本和第三方脚本影响。

• 至少测试：首页、一个转化页、一个长内容页、一个列表页和一个详情页。
• 把一方代码问题和第三方脚本问题分开，方便确认负责人。
• 开启 analytics、consent banner、聊天工具、评论和个性化脚本后再复测。

页面能渲染不代表上线完成。上线完成的标准是团队能看到搜索引擎和用户接下来在做什么。部署后要验证 Google Search Console、Bing Webmaster Tools、分析事件、转化追踪、consent 行为，如果有条件，也要看服务器日志。

给 SEO 验证留一个短窗口。提交 sitemap，检查几个优先 URL，查看抓取错误，确认索引状态，并在上线后 7 天、14 天、30 天对比自然搜索落地页。越早发现渲染或路由问题，损失越小。

• 生产部署后提交最终 sitemap，并检查优先 URL。
• 确认客户端路由切换后，转化事件只触发一次，而不是重复触发。
• 监控抓取错误、排除 URL、canonical 不一致和自然搜索落地页突然下降。