产品 SEO 与 GEO 智能体 付费广告智能体 网站智能体 转化智能体
运作方式 方案 常见问题 博客 预约通话

SPA SEO:如何让单页应用被 Google 收录

更新于 · 阅读约 8 分钟

简短回答 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 上看到了什么?

按顺序做三项检查:

  1. 查看原始 HTML。 打开一个页面,按 Ctrl+U(Mac 上按 Cmd+Option+U),搜索页面上的一句话。如果找不到,不运行 JavaScript 的爬虫什么也看不到。
  2. 查看 Google 渲染后的版本。 Google 建议用富媒体搜索结果测试或 Search Console 中的网址检查工具来“check if the rendered HTML has all content you expect”(检查渲染后的 HTML 是否包含您期望的全部内容)。两者都会显示 Google 运行代码后的页面,以及任何 JavaScript 错误。
  3. 数一数已收录的页面。 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`
VueNuxt,默认使用服务器端渲染,“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 指南为客户端应用给出了两种解决办法:

  1. 用 JavaScript 重定向到服务器会返回真正 404 状态码的网址,例如 `/not-found`。
  2. 用 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,对所有爬虫都不再是问题。

您的情况不同?

继续阅读

下一篇Noindex 检查:如何查看页面是否设置了 noindex检查单个页面 noindex 的四种方法:页面源代码、响应头、浏览器扩展和 Google 的网址检查工具。每种方法能查到什么、会漏掉什么。

自己动手

可抓取性检查清单:让 Google 能访问到每个页面小企业网站的可抓取性检查清单:用免费工具找出孤立页面、robots.txt 屏蔽、失效链接、重定向链和服务器错误。

问我们一个问题

一句话就够。我们会通过电子邮件回复。

出处

  1. Google Search Central: Understand the JavaScript SEO basics
  2. Google Search Central: Fix search-related JavaScript problems
  3. Google Search Central: Dynamic rendering as a workaround
  4. Google Search Central: Fix lazy-loaded website content
  5. Google Crawling Infrastructure: Crawl budget management
  6. Bing Webmaster Blog: JavaScript, dynamic rendering, and cloaking (October 2018)
  7. Vercel: The rise of the AI crawler (December 2024)
  8. React: Creating a React App
  9. React Blog: Sunsetting Create React App
  10. Next.js Docs: Metadata and OG images
  11. Vue.js: Server-Side Rendering (SSR)
  12. Nuxt Docs: Rendering modes
  13. Nuxt Docs: SEO and meta
  14. Angular: Server and hybrid rendering
  15. Angular Universal repository (archived)
  16. Angular API: Meta
  17. Lovable Docs: Optimize your app for SEO and AI search
  18. Meta for Developers: A guide to sharing for webmasters
  19. Google Analytics Help: Enhanced measurement events