巧用Html5 History Api解决SPA的SEO问题

SPA部署Nginx刷新404?详解History模式与try_files配置 单页应用(SPA)已成为现代Web开发的主流架构,它通过前端路由实现无刷新页面切换,提升用户体验。其核心原理在于利用Hash或History API管理浏览器URL与组件映射,其中History模式因URL简洁、对SEO友好而被广泛采用。然而,当SPA部署到Nginx等静态服务器时,History模式会面临一个关键挑战:服务器默认会尝试寻找与路由路径对应的物理文件,导致直接访问或刷新子页面时返回404错误。这体现了前端路由抽象与服务器文件系统寻址之间的技术鸿沟。为解决此问题,需要在Nginx中配置try_f 阅读详情

背景

想当年,我做了一个新媒体网站项目(AIISPO,已下线)。跟普通资讯网站不一样的是,老板要求PC端前台的文章阅读模式一定得是瀑布流+模态框。瀑布流指的是以瀑布流的形式将文章罗列出来,而模态框则指的是点击瀑布流中代表文章的某个文块时,直接在当前页面弹出模态框来显示文章正文。

瀑布流式的文章列表

瀑布流式的文章列表

利用模态框直接显示文章正文

点击瀑布流的某个文块后,直接在当前页面弹出模态框来显示正文以及文章相关内容,可依稀透过模态框背景看到底层的瀑布流。点击模态框背景可关闭模态框,相当于回到瀑布流。
利用模态框直接显示文章正文

平常的开始

其时,我正痴迷于MVVM框架avalon,于是,理所当然地用avalon来渲染瀑布流的DOM树。至于文章正文嘛,就用avalon给瀑布流中的各文块绑定个click事件,顺便把文章id给传到click事件的callback里,执行callback时就ajax读一下文章正文,最后放到模态框里显示就是了。
至此,老板要的“用户体验”就达成了,老板夸我厉害还给我涨工资,我心里美美哒 n(≧▽≦)n

问题初现

官网上线了几天,老板给我提出了一个非常“实际”的问题,他没法把文章的网址分享出去呀,这是因为:官网本来就没有独立的文章页面,更勿论文章的网址了!。当务之急是创建出可供分享的文章网址。

Hashbang登场

老板不接受“跳转新页面”打开文章正文的方案,坚持一定要瀑布流+模态框,我只好琢磨别的思路了。首先我试用window.location.href="/article/1",这是一定会使浏览器跳转而无法保持在当前页面的,pass。接下来我查资料就搜到这Hashbang的方案:利用改变锚点#不会导致页面跳转这一特点,并加上!这一独特的标识,形成形如http://aiispo.cn/#!/article/1的网址。

具体的方案是这样的:
1. 大体上跟最初的方案一致。
2. 不一样的地方在于,打开模态框的同时window.location.href="/#!/article/1",这时地址栏的地址便变为http://aiispo.cn/#!/article/1,也能保持不跳转。
3. 另外,给document.load绑上callback,也就是在页面加载好后取当前的hash(window.location.hash),会得到形如#!/article/1的字符串。正则匹配该字符串把文章ID取出,就可以直接显示文章正文了。
4. 在关闭模态框时,应把地址栏恢复回来。

如此一来,用户在阅读文章时地址栏里的正是文章的“网址”,而当用户把网址分享给别人,别人复制到浏览器一打开,就能看到那篇文章了。老板又夸我了,我心里又美美哒 n(≧▽≦)n

问题再现

官网上线月余,百度仅收录了首页,我打开首页的快照一看,可只有avalon的模板标签,我一下子就醒悟过来了:百度根本就没能爬到任何的文章,因为首页根本没有任何文章的链接!
这时候我才意识到在SEO方面出了大问题了,这对一个新媒体网站来说可是致命的呀,把问题报告老板后就赶紧开动脑筋想解决方案了。

小尝试

把心一横,把原本用avalon渲染的瀑布流,全部改回用PHP来渲染,同时给瀑布流的文块加上<a>标签,例如<a href="/#!/article/1">。由于加上了<a>标签,地址栏就不需要手动去改了。

问题未解

又过了几天,各个搜索引擎还是没有动静,我便又开始查资料:原来,国内的搜索引擎在抓取页面的时候,是不执行js的。换句话说,搜索引擎从http://aiispo.cn/#!/article/1这样的网址进去,只能看到瀑布流而看不到文章正文,因为文章正文是后面用js渲染的,不执行js就没法渲染,而瀑布流是用PHP渲染成html的,搜索引擎能看得到。据说Google是会执行js的,不过作为一个国内的网站,还是得优先保证国内的搜索引擎。

上Html5 History Api

思量良久,问题还是出在文章没有独立的页面上,另外Hashbang这种URL也不可靠,无法被后端识别。痛定思痛,这次一定要彻底解决问题。

改造如下:
1. 仿照模态框的UI,我给做了文章的独立页面,URL形如http://aiispo.cn/article/1。
2. Hashbang不成,我就找其它能修改地址栏但不跳转的方案,结果就找到了Html5 History Api:
1. 把瀑布流文块里的<a href="/#!/article/1">改为<a href="/article/1">。
2. 改这href会导致用户点击后跳转,因此需要用js拦截<a>不让其跳转,并改为用window.history.pushState()来设置地址栏,此时用户的地址栏应为http://aiispo.cn/article/1。

  $('#article-list a').on('click', function() {
    var url = $(this).attr('href');
    window.history.pushState(null, null, url);
    return false;
  });
  1. 照样用正则匹配出文章ID,并用模态框显示文章正文。

如此一来,便兼顾了三方的需求:
1. SEO的需求,搜索引擎抓取瀑布流能抓到文章独立页面的URL(形如http://aiispo.cn/article/1),通过此URL进入文章独立页面能抓取到文章正文。
2. 用户体验的需求,完美地保留了瀑布流+模态框的阅读模式。
3. 用户分享文章网址的需求,用户在瀑布流打开文章时,地址栏正是文章独立页面的URL。

兼容性修正

上述方案依赖于Html5 History Api,而IE9及以下版本都是不支持Html5 History Api的,需要进行兼容性修正。
在权衡利弊后,最终决定放弃IE9-用户的用户体验:
1. 检测当前浏览器是否支持Html5 History Api。
2. 不支持的话,就不拦截瀑布流文块的<a href="/article/1">,也就是直接让其跳转。

总结

我的这套方案,本质上跟Prerender没有区别,都是让后端模拟前端渲染的方式生成一个独立的页面供搜索引擎抓取,既兼顾用户体验,又不失SEO。

PCB布线避坑指南:晶振布局的5个致命错误(附正确示例图) 本文深入解析PCB布线中晶振布局的5个致命错误,包括底层布线、电容布局、地平面处理等关键问题,并提供实战解决方案。通过真实案例和量化数据,帮助硬件开发者避免常见陷阱,提升电路稳定性和性能。特别针对晶振这一高敏感元件,给出布线参数黄金法则和三维避让原则。 阅读详情

相关推荐

通过JLink下载实现工控MCU批量烧录实战案例

利用JLink下载工具实现高效稳定的工控MCU批量烧录,提升产线效率。案例详细解析了脚本配置与自动化流程,突出jlink下载的可靠性和可扩展性,适用于大规模嵌入式部署场景。

weixin_30205153的博客 815

关于vue的seo优化

好长时间没有写博客了,这个月的18号才写这个月的第一篇,回首一看这个月发生了好多事情。换工作、加班都没有时间和没有好的东西可以写。最近公司的项目中有一个非常重要的功能就是seo的优化,这个东西堵了一段时间,中间还去请教了好些人都没有得到好的解决办法。后来自己通过webpack和prerender-spa-plugin第三方插件这两个工具配合使用来实现曲线就救国。 问题描述 传统的vue通过vu...

qq_40816649的博客 2万+

GAN管CGH40010F设计宽带Doherty功放:如何用ADS搞定输入匹配、合路网络与功分器?

本文详细介绍了基于CGH40010F GaN晶体管的宽带Doherty功放设计流程,重点讲解在ADS平台中实现输入匹配网络、合路网络与功分器的关键技术。通过寄生参数补偿、渐变微带线设计和复合补偿结构等方法,解决了宽带化设计中的核心挑战,最终实现1.7-2.6GHz频段内72%的峰值效率和52%的回退效率。

weixin_42614269的博客 473

单页面应用(SPA)&&前端路由hash 模式 VS history 模式

单页面应用(SPA)&&前端路由hash 模式VS history 模式 前端路由的由来 保证只有一个 HTML 页面,且与用户交互时不刷新和跳转页面的同时,为 SPA 中的每个视图展示形式匹配一个特殊的 url。在刷新、前进、后退和SEO时均通过这个特殊的 url 来实现。 history兼容性不如 hash,且需要服务端支持,否则一刷新页面就404了

LYFlied的博客 1753

【定位模块算法】amcl(蒙特卡洛)粒子滤波定位算法(附C++代码)

系列文章目录 提示:这里可以添加系列文章的所有文章的目录,目录需要自己手动添加 TODO:写完再整理 文章目录系列文章目录前言(1)amcl定位框架介绍(2)amcl定位框架组成(1)ROS-TF坐标转换树【ROS的工具】(2)robot_pose_ekf扩展卡尔曼位姿估计算法(3)定位amcl自适应蒙特卡洛定位,adaptive monte carlo localizaion**(3)amcl定位节点的订阅与发布(4)amcl定位功能包用法(1)编写amcl节点相关的launch(amcl_omni.l

qq_35635374的博客 4403

AMBA总线协议(5)——AHB(三):猝发传输

在本文中我们展现了AHB猝发传输的具体细节,学习了猝发的类型和具体传输方式,着重讲解了四拍回卷猝发,猝发是AHB传输中非常重要的一部分。

apple_53311083的博客 3643

前端vue项目,单页面应用(SPA)SEO优化可能遇到的问题及解决方案

前端vue项目,单页面应用(SPA)SEO优化可能遇到的问题及解决方案

qq_34841115的博客 1186

【Simulink教程案例19】基于simulink的扩频通信系统建模与仿真

扩频是一种应用于数字调制信号的调制技术,可以提高传输信号的带宽。扩频通信具有抗干扰能力强,扩频增益越大,抗干扰能力越强。而且扩频通信具有很强的保密性,扩频后信号近似白噪声,功率谱密度也很低。扩频通信可用于多址通信。扩频调制有如下三个特点:① 扩频后信号的带宽远大于信号所需的带宽② 使用扩频码进行扩频调制,扩频码与信号中的数据相互独立③ 在接收端,通过将接收信号与扩频码的同步副本进行相关,实现解扩。

FPGA/MATLAB学习教程/源码/项目合作开发 2197

vue 使用 prerender-spa-plugin 预处理 seo优化 导致 history模式 页面刷新 文件加载404 问题

nginx已经加了 没有使用prerender-spa-plugin插件之前history正常,增加插件后刷新文件加载异常 main.js 404问题原因及解决 由于前端 vue.config 配置的 publicPath 路径 使用了 './'相对路径(当时为了方便前端测试)正确方式publicPath 更改为’/'绝对路径...

HHH917的博客 1029

SAP特殊库存全解析:供应商寄售、客户寄售、分包与项目库存说明

客户寄售库存(Customer Consignment)是企业将物料存放于客户处,客户实际领用后才确认销售收入。这种模式能缩短交货周期、提高客户满意度,但需严格跟踪寄售库存的数量与状态。

我小时候很黑的博客 823

华为OD-C卷D卷-音乐小说内容重复识别[200分][Python/C++/Java]两种解法实现(并查集+动态规划)

如果不相似,返回不相似的内容。输入:两条语句,给出是否相似,对于相似的语句,返回True和相似的字符对;给出相似对"(****)",""时,"异世邪君(人气玄幻作家)" 和 "异世邪君" 认为是相似,此时相似符号范围 *** 即可。例如,如果"顿号"和"逗号"是相似的,"逗号"和"分号"是相似的,则"顿号"和"逗号"是相似的。初始化:给出两个字符串,一些相似字符对,如顿号和逗号相似,的和de相似,猪和潴,给出两个字符串的相似判断结果。不相似的内容,需要给出不相似的字符串,多处不相似的字符串用空格分隔。

算法算法算法!!! 2001

spa应用seo优化方案(arm服务器)

最近公司需要对网页进行seo优化,奈何项目为vue的spa应用,没那么方便改造,所以记录一下优化经历 一、非SSR项目进行seo优化有以下四种方案: 二、文件编写 ssr文件: const puppeteer = require('puppeteer'); const Cacheman = require('cacheman'); const md5 = require('md5'); let browserWSEndpoint = null; const FilecCache = new Cacheman

cpa0701的博客 1308

机器学习笔记——30种常见机器学习算法简要汇总

本笔记介绍机器学习中常见的30种机器学习算法。

haopinglianlian的博客 3201

5个常见prerender-spa-plugin问题解决指南:从路由404到CSS重复加载

prerender-spa-plugin是一款用于单页应用预渲染静态HTML的工具,能有效提升SPA应用的首屏加载速度和SEO表现。本文将针对开发者使用过程中最常遇到的5类问题,提供清晰易懂的解决方案,帮助你快速排查并解决预渲染相关难题。 ## 1. 路由404错误:预渲染页面无法访问的快速修复 当预渲染后的页面出现404错误时,通常与路由配置或输出路径设置有关。首先检查`webpack.co

gitblog_00538的博客 827

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

廖雪峰Python教程[完整版]

廖雪峰的python教程整理的,已经排好版了,而且还是完整的,适合小白

HTML5 History 模式 5分钟讲清楚

(相当于“修改当前URL”),不会新增记录。

jongden的专栏 1297

锂电池充电器电路设计 里面有电路

锂电池充电器电路设计 里面有电路 3.7V升压到5V电路设计。

HTML5的History API有哪些方法?如何实现无刷新页面跳转?

当你在刷网页时,有没有遇到过点击链接后,页面突然“白屏”刷新,好不容易加载到一半的内容瞬间消失,等待许久才出现新页面?这种体验就像喝到一半的奶茶突然打翻,让人无比烦躁。而在前端开发中,传统的页面跳转方式带来的刷新卡顿,不仅影响用户体验,还可能导致用户流失。好在HTML5带来了救星——History API,它就像一剂“特效布洛芬”,能快速缓解页面跳转带来的“疼痛”,实现无刷新页面跳转,让用户浏览如丝般顺滑。接下来,我们就深入了解HTML5的History API有哪些神奇方法,以及如何用它们实现无刷新页面跳

前端大白话 1104

ET2012新版免狗免安装绿色软件

ET2012新版免狗免安祖昂绿色软件。,新界面,新视觉,

SPA路由回退机制解析:解决History模式下的404问题

在单页应用(SPA)开发中,路由管理是一个核心问题。特别是使用History模式时,直接访问深层路由路径会出现404错误。本文将深入分析一个实际项目中的路由回退解决方案,从服务器端到前端客户端的完整实现。History模式是Vue Router的一种路由模式,它使用HTML5 History API来管理路由状态。URL更加美观,没有符号支持SEO优化更符合传统Web应用的URL结构SPA路由回退机制是解决History模式404问题的标准方案。通过服务器端返回index.html。

2501_92822955的博客 874

前端路由历史管理:从History API原理到SPA状态恢复实战

在前端单页应用(SPA)开发中,路由管理是构建流畅用户体验的核心技术。其底层原理基于浏览器提供的History API,通过pushState、replaceState方法操作浏览历史栈,结合popstate事件监听实现无刷新页面跳转。这项技术的核心价值在于实现应用状态与URL的同步,确保用户操作路径的可追溯性。在实际工程实践中,开发者常面临状态丢失、路由劫持、历史栈污染等典型问题,尤其在需要实现复杂编辑器的撤销/重做、多步骤表单路径锁定时,原生API往往力不从心。本文聚焦于构建健壮的历史记录管理器,通过封

weixin_33834075的博客 594

Vue history模式刷新页面404问题

为什么会出现404 我们先来看一下我们给到后端的dist文件 可以看到dist下只有一个index.html文件及一些静态资源,这个是因为Vue是单页应用(SPA),只有一个index.html作为入口文件,其它的路由都是通过JS来进行跳转 接着我们再来分析一下后端nginx的配置 server{ //监听80端口 listen80; //定义你的站点名称 server_namewebsite.com; //根据请求URI设置配置 l...

qq_32421489的博客 1万+

什么是SPA,如何实现SPA应用呢?

SPA(single-page application),翻译过来就是单页应用是一种网络应用程序或网站的模型,它通过动态重写当前页面来与用户交互,这种方法避免了页面之间切换打断用户体验在单页应用中,所有必要的代码(、和)都通过单个页面的加载而检索,或者根据需要(通常是为响应用户操作)动态装载适当的资源并添加到页面页面在任何时间点都不会重新加载,也不会将控制转移到其他页面举个例子来讲就是一个杯子,早上装的牛奶,中午装的是开水,晚上装的是茶,我们发现,变的始终是杯子里的内容,而杯子始终是那个杯子结构如下图我们熟

qq_43375584的博客 2004

jQuery Address终极教程:如何实现单页面应用(SPA)的深度链接

jQuery Address是一款强大的深度链接插件,专为单页面应用(SPA)设计,让您的Web应用支持浏览器历史记录、书签和分享功能。这个jQuery插件通过提供完整的深度链接解决方案,解决了SPA应用中URL管理的核心问题。无论您是构建复杂的Web应用还是简单的单页面网站,jQuery Address都能帮助您实现优雅的URL导航和状态管理。 ## 📋 什么是深度链接?为什么它如此重要?

gitblog_00209的博客 659

解决90%单页应用状态丢失问题:History.js持久化方案全解析

单页应用(SPA)开发中,页面状态丢失是开发者最头疼的问题之一。用户在页面间切换时,刷新浏览器或点击后退按钮常常导致状态重置,严重影响用户体验。**History.js**(版本1.8.0)作为一款成熟的前端历史管理库,通过优雅地支持HTML5 History/State APIs(pushState、replaceState、onPopState),为解决这一痛点提供了完整解决方案。无论是现代浏

gitblog_00377的博客 484

你对 SPA 单页面应用的理解?它的优缺点分别是什么?如何实现 SPA 应用?

摘要:本文全面解析了单页应用(SPA)的概念、实现原理及优化方案。SPA通过前端路由实现无刷新页面切换,提供接近原生应用的流畅体验。文章详细对比了SPA与多页应用(MPA)的区别,阐述了SPA的优缺点,并提供了基于Hash和History两种路由模式的完整实现代码。针对SPA的SEO问题,提出了服务端渲染、静态预渲染和动态渲染三种解决方案。最后总结指出,SPA是现代Web开发的主流范式,开发者应根据业务需求选择合适的技术方案来平衡性能、体验与可访问性。

m0_67393827的博客 1177

vue-router 2.x HTML5 History 模式实战指南:从 hash 到 history 的配置与服务器部署

`vue-router`(Vue 2 官方路由)默认使用 hash 模式,通过 URL 中的 `#` 模拟完整 URL,避免页面刷新;而 history 模式借助浏览器 `history.pushState` API 实现无刷新的 URL 导航,让地址栏呈现如 `http://oursite.com/user/id` 这样“正常”的路径。本文以 [docs/kr/guide/essentials/

gitblog_00265的博客 363

hash和history路由的区别

在了解路由模式前,我们先看下 什么是单页面应用,vue-router 的实现原理是怎样的,这样更容易理解路由。

发果叁 3385

前端路由的两种模式:hash 与 history 深度解读

Vue-Router提供hash和history两种路由模式:hash模式通过监听hashchange事件实现路由切换,URL带#号,兼容性好但不够美观;history模式利用HTML5 History API实现无#号的URL,需要服务器配置支持但更符合标准。hash模式适合兼容性要求高的场景,history模式更适合追求美观URL和功能完善的现代应用。选择时需考虑浏览器兼容性、后端配置权限、URL美观度及SEO需求等因素。

27前端选手nck的博客 1021
上一篇: 记离线缓存(manifest)一大坑,断定其只适用于静态网站或离线应用
下一篇: ES6部分方法点评(一)
array_huang
博客等级 码龄11年 15粉丝 32原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值