我们来看看官方文档是教我们怎么配置的:HTML5 History 模式。
首先要将mode
设置为 history
:
const router = new VueRouter({
mode: 'history',
routes: [...]
})
nginx
location / {
try_files $uri $uri/ /index.html;
}
然后就没了...
这里我们需要清楚为什么会报404:
我们用nginx部署项目,然后在地址栏输入 http://dev.mds/(这里配置的端口是8080),你会发现地址栏之后会变为 http://dev.mds/home,并且 看起来一切正常, 似乎路由也可以正常切换而不会发生其他问题(实际上会发生问题,后面会进行讨论)。看起来好像不需要按官网告诉我们的那样配置后端也能实现 history模式,但如果你直接在地址栏输入 http://dev.mds/home,你会发现你获得了一个404页面。
那么 http://dev.mds/ 为什么可以(部分)正常显示呢?道理其实很简单,你访问 http://dev.mds/时,静态服务器(这里是nginx)会默认去目标目录(这里为 location中 root所指定的目录)下寻找 index.html(这是nginx在端口后没有额外路径时的默认行为),目标目录下有这个文件吗?有!然后静态服务器返回给你这个文件,配合 vue-router进行转发,自然可以(部分)正常显示。
但如果直接访问 http://dev.mds/home,静态服务器会去目标目录下寻找 home 文件,目标目录下有这个文件吗?没有!所以自然就404了。
配置后端
为了达到直接访问 http://dev.mds/home也可以成功的目的,我们需要对后端(这里即nginx)进行一些配置。
首先想想,要怎样才能达到这个目的呢?
在传统的hash模式中( http://dev.mds/#/home),即使不需要配置,静态服务器始终会去寻找index.html并返回给我们,然后 vue-router 会获取#后面的字符作为参数,对前端页面进行变换。
类比一下,在 histroy
模式中,我们所想要的情况就是:输入http://dev.mds/#/home,但最终返回的也是index.html,然后 vue-router 会获取home作为参数,对前端页面进行变换。那么在nginx中,谁能做到这件事呢?答案就是try_files。
首先看一下try_files的语法: try_files file ... uri;
然后看一下官方文档对它的介绍:
Checks the existence of files in the specified order and uses the first found file for request processing; the processing is performed in the current context. The path to a file is constructed from the
file
parameter according to the root and alias directives. It is possible to check directory’s existence by specifying a slash at the end of a name, e.g. “$uri/
”. If none of the files were found, an internal redirect to theuri
specified in the last parameter is made.
解释:
关键点1:按指定的file顺序查找存在的文件,并使用第一个找到的文件进行请求处理
关键点2:查找路径是按照给定的root或alias为根路径来查找的
关键点3:如果给出的file都没有匹配到,则重新请求最后一个参数给定的uri,就是新的location匹配
关键点4:如果是格式2,如果最后一个参数是 = 404 ,若给出的file都没有匹配到,则最后返回404的响应码
举例说明:
location / {
root html;
index index.html index.htm;
try_files $uri $uri/ /index.html;
}
大意就是它会按照 try_files后面的参数依次去匹配 root中对应的文件或文件夹。
如果匹配到的是一个文件,那么将返回这个文件;如果匹配到的是一个文件夹,
那么将返回这个文件夹中 index指令指定的文件。
最后一个 uri参数将作为前面没有匹配到的fallback。(注意 try_files指令至少需要两个参数)
其他注意事项:
try-files 如果不写上 $uri/,当直接访问一个目录路径时,并不会去匹配目录下的索引页 即 访问location/images/ 不会去访问 location/images/index.html
举个我自己网站的例子:
location / {
root html;
index index.html index.htm;
try_files $uri $uri/ /index.html;
}
假设网站地址是http://history.test
这里我们直接访问的话,浏览器会去寻找http://history.test所在服务器的根目录下面的index.html,这样是能够加载inde.html的。
而当我们访问http://history.test/home时,首先回去查找有无home文件,如果没有,再去查找有误home目录,如果也没有最终就会定位到第三个参数从而返回index.html,按照这个规则,所有路由里的url路径最后都会定位到index.html。
而$uri这个参数的作用其实是匹配那些.js文件用的,而$uri/在这个例子中并没有多大用,实际上是可以去掉的。
在将我的项目(在路由中用了懒加载)改为 history模式的过程中,有时候发现会出现chunk加载出错的情况,打开chrome的network发现那个chunk加载404了,是因为请求的url中多了一层路径。我在这里发现了解决方案。
在 history 模式中切换路由时,我们是真正改变了页面的 url 路径,所以webpack的runtime会认为它位于 example.com/some/path。如果 publicPath是设置的相对路径,那么webpack加载chunk时可能会变成 example.com/some/path/static/js/3.js这样的路径,然而chunk的真正路径是 example.com/static/js/3.js,所以我们需要将 publicPath设置为绝对路径( publicPath: '/')来解决这个问题。