SPA路由与SEO的矛盾：为什么需要特殊处理？
单页应用（SPA）凭借流畅的用户体验和前后端分离的架构优势，成为现代Web开发的主流选择。然而，SPA依赖JavaScript在前端动态渲染内容，其路由切换本质上是通过hash模式（#）或History API实现。百度搜索引擎的爬虫在抓取时，通常不会执行复杂的JS逻辑，导致爬虫看到的页面往往是白屏或初始状态，无法索引到真正的路由内容。要让SPA在百度搜索中获得良好收录，必须对路由历史进行针对性优化。
核心方案：从History模式到服务端适配
首先，推荐将SPA路由从hash模式切换为History模式。Hash模式中的“#”符号会被百度爬虫视为锚点而非路径，导致路由内容被忽略。而History模式使用正常的URL路径（如/article/123），更有利于爬虫识别和抓取。不过，切换History模式后，需要服务器端配合：当用户直接访问某个路由或爬虫发起请求时，服务器必须返回入口HTML文件（通常是index.html），再由前端JS接管路由。如果服务器未做此配置，用户刷新页面就会返回404，爬虫也会同样受困。
预渲染：让爬虫直接获取静态HTML
预渲染是解决SPA SEO问题的常见方法。通过预渲染工具（如Prerender SPA Plugin或Rendertron），在构建阶段为每个路由生成对应的静态HTML页面。当百度爬虫访问时，服务器根据User-Agent判断，直接返回预渲染后的静态内容，而普通用户则正常加载SPA应用。这样做的好处是：爬虫无需执行任何JavaScript，就能获取到完整的标题、描述和正文。需要注意的是，预渲染生成的HTML应包含正确的<title>和<meta>标签，否则爬虫可能仍然无法正确识别页面主题。
动态渲染：更灵活的服务端处理
如果应用路由数量很大或内容频繁更新，预渲染的维护成本会比较高。此时可以考虑动态渲染方案。具体做法是：在服务器端（如Nginx或Node.js中间件）检测请求来源，如果识别为百度爬虫（User-Agent包含Baiduspider），则通过无头浏览器或渲染服务实时抓取SPA页面，生成完整的HTML再返回给爬虫。动态渲染能确保爬虫每次看到最新的内容，但会增加服务器负载，通常建议配合缓存机制使用——对同一路由的爬虫请求结果缓存一定时间，避免重复渲染。
关键细节：确保路由内容可被索引
- 避免客户端重定向：SPA中常见的“用户认证后跳转”操作，如果通过前端JS进行重定向，爬虫可能无法跟随。尽量在服务器端处理301/302重定向，或使用
<meta http-equiv="refresh">。 - 正确设置canonical标签：如果同一内容可通过多个路由访问（如带参数和不带参数的版本），务必在页面头部添加
<link rel="canonical" href="..." />，告诉爬虫哪个是优先索引的版本。 - 合理使用sitemap：为所有SPA路由生成XML格式的站点地图，并提交到百度搜索资源平台。sitemap中应使用History模式下的真实URL，帮助爬虫更快发现新路由。
- 检查路由变化后的标题更新：在SPA路由切换时，务必通过前端代码动态更新
document.title和<meta>标签。爬虫虽然不执行大部分JS，但预渲染或动态渲染生成的HTML中需要包含对应路由的标题和描述。
常见误区与注意事项
误区一：认为只要用了History模式，百度就一定能抓取所有路由内容。
事实是：History模式解决了URL形式问题，但爬虫依然需要服务器返回正确页面，并配合预渲染或动态渲染才能获取内容。误区二：在SPA中使用大量无意义的hash片段或#!样式URL。
百度爬虫对这类URL的索引能力有限，建议直接采用标准路径。误区三：忽略移动端适配。百度移动搜索的爬虫同样不执行JS，移动端SPA路由需要和桌面端同等优化。
如果项目刚起步，建议从History模式 + 预渲染入手，配置简单且效果稳定。内容频繁变动的应用可逐步迁移到动态渲染方案，并利用缓存降低服务器压力。无论选择哪种方式，务必通过百度搜索资源平台的“抓取诊断”工具验证爬虫能否正确获取页面内容，持续观察收录情况并做出调整。单页应用的路由历史处理并非一劳永逸，但随着百度对JS的支持逐步增强，合理的技术选型完全可以让SPA在搜索中获得公平的可见度。
在上周举行的FOMC（联邦公开市场委员会）会议中，卡什卡利是支持加息25个基点的三名票委之一。
评论区
热门讨论 · 占位展示期待你的精彩发言。