SPA SEO:如何让单页应用被 Google 收录
简短回答 Google 可以收录单页应用,但它要先运行页面的 JavaScript 才能读取内容,这一步可能延迟或失败;而很多其他爬虫,包括 AI 爬虫,根本不运行 JavaScript。让每个页面的文字以 HTML 形式发出(服务器端渲染或预渲染),给每个视图一个独立网址,并为每个页面设置不同的标题。
想把这些用到您的生意上?预约一次 30 分钟的免费通话,一起聊聊。
预约通话Google 能收录单页应用吗?
能,但会有延迟,也有风险。单页应用(SPA)发给浏览器的是一个几乎空白的页面加上 JavaScript,访客看到的内容由 JavaScript 生成。Google 必须先运行这些代码,才能读到您的文字。Google 的 JavaScript SEO 指南说,等待这一步的页面“may stay on this queue for a few seconds, but it can take longer than that”(可能在队列中停留几秒,但也可能更久)。同一份指南在解释的结尾给出了一锤定音的建议:
"Keep in mind that server-side or pre-rendering is still a great idea because it makes your website faster for users and crawlers, and not all bots can run JavaScript." (Google Search Central: Understand the JavaScript SEO basics) 译文:“请记住,服务器端渲染或预渲染仍然是很好的做法,因为它能让您的网站对用户和爬虫都更快,而且并非所有机器人都能运行 JavaScript。”
| 谁在读取您的网站 | 运行 JavaScript 吗? | 在普通 SPA 上看到什么 |
|---|---|---|
| Google 搜索 | 运行,但稍后在第二步进行 | 您的内容,前提是代码运行无误 |
| 其他搜索引擎 | 不一定。Google 说它们“may choose to ignore JavaScript”(可能选择忽略 JavaScript) | 可能是空白页面 |
| AI 爬虫(ChatGPT、Claude) | 不运行,据 2024 年 12 月对 Vercel 网络的一项研究 | 空白页面 |
这项研究来自 Vercel:通过监测其托管网络上的流量,它发现“none of the major AI crawlers currently render JavaScript”(目前主要的 AI 爬虫都不渲染 JavaScript)。如果您希望 ChatGPT 或 Claude 引用您的服务,文字必须在 HTML 里。
怎样查看 Google 在我的 SPA 上看到了什么?
按顺序做三项检查:
- 查看原始 HTML。 打开一个页面,按 Ctrl+U(Mac 上按 Cmd+Option+U),搜索页面上的一句话。如果找不到,不运行 JavaScript 的爬虫什么也看不到。
- 查看 Google 渲染后的版本。 Google 建议用富媒体搜索结果测试或 Search Console 中的网址检查工具来“check if the rendered HTML has all content you expect”(检查渲染后的 HTML 是否包含您期望的全部内容)。两者都会显示 Google 运行代码后的页面,以及任何 JavaScript 错误。
- 数一数已收录的页面。 Search Console 的“网页”报告会显示哪些网址被收录了。一个有 20 个页面却只有 1 个网址被收录的网站,通常是网址出了问题(见下文)。请参阅小企业如何使用 Google Search Console。
如果第 1 步不通过、第 2 步通过,说明 Google 能读到您,其他爬虫读不到。如果两步都不通过,先解决渲染问题。
SSR、预渲染还是动态渲染:该选哪种?
把文字放进服务器发出的 HTML 里。有三种做法,Google 推荐其中两种。
| 方法 | 含义 | 最适合 | 缺点 |
|---|---|---|---|
| 服务器端渲染(SSR) | 每次有人请求时,由服务器生成该页的 HTML | 经常变动的页面:价格、列表、库存 | 需要一直运行的服务器,成本更高 |
| 预渲染,或静态网站生成(SSG) | 每个页面的 HTML 在发布时一次生成 | 服务页、关于我们、联系页、博客 | 内容一改就要重新构建 |
| 动态渲染 | 机器人拿到预先生成的副本,真人使用应用 | 暂时无法重建的旧应用的权宜之计 | Google 已不再推荐 |
Vue 的文档给了业主一个实用的捷径:如果您考虑 SSR 只是为了改善少数营销页面(例如 / 和 /about)的 SEO,那您可能需要的是 SSG。对于动态渲染,Google 说得很直接:
"Dynamic rendering was a workaround and not a long-term solution for problems with JavaScript-generated content in search engines." (Google Search Central: Dynamic rendering as a workaround) 译文:“动态渲染是一种权宜之计,并不是解决搜索引擎中 JavaScript 生成内容问题的长期方案。”
Google 还说,只要两个版本内容相似,它一般不会把动态渲染视为伪装(cloaking,即给机器人和真人看不同的内容)。
React、Vue 和 Angular:解决办法在哪里
现在每个框架都自带服务器端渲染的方式,您的开发人员很少需要自己搭建。
| 用什么构建 | 渲染选项 | 页面标题和描述 |
|---|---|---|
| React | 使用 Next.js 或 React Router 等框架。React 文档说:“we recommend starting with a framework”(我们建议从框架开始) | Next.js:`metadata` 或 `generateMetadata`。React Router:每个路由导出一个 `meta` |
| Vue | Nuxt,默认使用服务器端渲染,“to optimize search engine indexing”(以优化搜索引擎收录) | Nuxt:`useSeoMeta` 或 `useHead` |
| Angular | `@angular/ssr`,用 `ng add @angular/ssr` 添加。不添加的话,Angular 应用在客户端渲染 | Angular 的 `Title` 和 `Meta` 服务 |
| AI 应用生成工具(Lovable) | 2026 年 5 月 13 日起(企业版为 6 月 22 日)的新应用使用服务器端渲染;更早的应用会为经过验证的爬虫提供预渲染版本 | 在生成工具里设置 |
旧建议中的两个名字已经过时。Create React App 于 2025 年 2 月 14 日停止推荐用于新应用(React Blog)。Angular Universal 在 Angular 17 中并入 `@angular/ssr`,其代码库已于 2024 年 11 月 22 日归档。如果报价或方案里出现其中任何一个,请问清楚原因。
每个视图都需要独立网址吗?
需要。网址是 Google 唯一能收录的东西,所以没有独立地址的服务页无法单独获得排名。旧的 SPA 常用 `example.com/#/services` 这样的地址。Google 的故障排除指南说,针对这类地址的旧方案已经不再支持:
"The AJAX-crawling scheme has been deprecated since 2015, so you can't rely on URL fragments to work with Googlebot." (Google Search Central: Fix search-related JavaScript problems) 译文:“AJAX 抓取方案自 2015 年起已被弃用,因此您不能指望网址片段对 Googlebot 有效。”
解决办法是用浏览器的 History API 做路由,让每个视图都有 `example.com/services` 这样的普通地址。三个框架的现代路由默认都是这样做的。链接必须是真正的链接:Google 说它只能发现带 `href` 地址的 HTML 链接元素(`a` 标签)。用点击事件切换视图的按钮,会让该页面对 Google 不可见。然后把所有公开网址列进站点地图,并在 Search Console 中提交。
在 SPA 中如何为每页设置标题和元标签?
给每个网址设置独立的标题、描述和规范标签(canonical,指明某个页面主版本的标签)。Google 说标题和描述可以由 JavaScript 设置。有两个标签需要多加小心:
- 规范标签: 写在 HTML 里。Google 说如果由 JavaScript 设置,它必须与原始 HTML 中的值一致,而且只能有一个。
- Noindex: 不要在您希望被找到的页面的初始 HTML 里放 noindex,再打算之后用 JavaScript 去掉。Google 的指南警告:“When Google encounters the noindex tag, it may skip rendering and JavaScript execution”(当 Google 遇到 noindex 标签时,可能会跳过渲染和 JavaScript 执行)。
要让链接在 Facebook、LinkedIn 或短信中显示预览,请为每个网址添加 Open Graph 标签(`og:title`、`og:description`、`og:image`、`og:url`)。Meta 的指南说:“To see how your markup appears to the Facebook Crawler enter a URL into Sharing Debugger”(要查看 Facebook 爬虫如何看待您的标记,请在分享调试器中输入网址)。如果每个分享出去的链接都显示首页标题,说明您的标签只由 JavaScript 设置,或者只设置了一次。
结构化数据(schema 标记)也可以来自 JavaScript:Google 说您可以生成 JSON-LD 并注入页面,然后进行测试。富媒体搜索结果测试会显示 Google 是否看到了它。
页面不存在和软 404 怎么办?
SPA 常常对每个地址,哪怕是输错的地址,都返回“200 OK”状态码,然后再用 JavaScript 显示“页面未找到”。Google 把这称为软 404(自称正常的错误页面)。Google 的 JavaScript 指南为客户端应用给出了两种解决办法:
- 用 JavaScript 重定向到服务器会返回真正 404 状态码的网址,例如 `/not-found`。
- 用 JavaScript 给错误视图添加 `noindex` robots 元标签。
速度、延迟加载和抓取预算重要吗?
速度对访客很重要;抓取预算对小企业几乎从不重要。Google 的抓取预算指南针对的是拥有“1 million+ unique pages”(100 万个以上不重复页面)或每天变动的“10,000+ unique pages”(1 万个以上不重复页面)的网站。一个 30 页的服务网站远远达不到。
延迟加载(滚动到时才加载图片)没问题,只要遵循 Google 的指南:在内容“whenever it is visible in the viewport”(出现在视口中时)加载,使用浏览器内置的延迟加载或 IntersectionObserver API。首屏显示的内容不要延迟加载。Google 没有公布它会等待 JavaScript 多少秒;真正的风险是代码出错,或要等用户点击才加载内容。关于速度和排名,请参阅 Core Web Vitals。
GA4 能追踪 SPA 中的页面浏览吗?
通常可以,不用写代码。GA4 的增强型衡量会在页面加载时,“or the browser history state is changed by the active site”(或当前网站更改浏览器历史记录状态时)发送页面浏览事件,帮助页面还说这个选项会“listens for pushState, popState, and replaceState”(监听 pushState、popState 和 replaceState)。前提是每个视图都会改变网址,这又是一个要把路由修好的理由。要追踪电话和表单,请参阅 GA4 关键事件。
示例
以下为示意案例,数字为虚构。
一家清洁公司用 Vue 做的预约网站(美元)
Search Console 显示 12 个页面中只有 1 个被收录,而且每个地址都以 `/#/` 开头。开发人员把路由切换为 History 模式,添加站点地图,并为每页设置标题。把 12 个公开页面迁移到 Nuxt 预渲染后,AI 爬虫也能在 HTML 中读到文字。报价:$1,500 到 $3,000。
多伦多一家物理治疗诊所的 React 应用(加元)
网站用 Create React App 搭建。查看源代码只看到一个没有文字的空页面框架。用 Next.js 重建公开页面的报价是 C$4,000;登录后的患者门户仍保持普通 SPA,因为它不需要被搜索到。
2026 年初业主自己用 Lovable 搭建的网站
它早于 2026 年 5 月的切换,所以爬虫拿到的是预渲染副本。网址检查显示了完整文字;业主确认每项服务都有自己的网址和标题,然后提交站点地图。
常见问题
SPA 对 SEO 不好吗?
本身不是。只在客户端渲染的 SPA 对需要被找到的页面有风险;同一个应用加上服务器端渲染或预渲染后,收录情况和普通网站一样。
我需要重建整个应用吗?
通常不需要。把公开页面(首页、服务、价格、联系)放到服务器端或构建时渲染即可。登录后的区域可以继续在客户端渲染,它们本来就不应该出现在搜索结果里。
prerender.io 或类似服务安全吗?
那就是动态渲染。只要机器人和真人看到的内容相似,Google 可以接受,但它称之为权宜之计,而不是长期方案。
Bing 会渲染 JavaScript 吗?
2018 年,Bing 写道它的爬虫“is generally able to render JavaScript”(一般能够渲染 JavaScript)(Bing Webmaster Blog),但 Google 自己的指南提醒,其他搜索引擎可能会忽略 JavaScript。直接提供 HTML,对所有爬虫都不再是问题。
您的情况不同?
- 您的网站在 Google 上完全搜不到:网站在 Google 上搜不到。
- Search Console 显示“已发现”或“已抓取 - 尚未编入索引”:这些状态是什么意思。
- 换成新应用后流量下降:网站改版后流量下降。
- 您在选的是建站平台而不是框架:Wix、Squarespace 还是 WordPress 更利于 SEO。
- 您想要一个一开始就为被找到而建的网站:网站智能体。
- 您想请人检查并修复收录问题:SEO 与 GEO 智能体。