解决Vue-routerhistory模式页面404

时间:2024-04-09 17:28:23

history模式出现404的原因

通过history api,我们丢掉了丑陋的#,但是它也有个问题:不怕前进,不怕后退,就怕刷新,f5,(如果没有准备的话),因为刷新是实实在在地去请求服务器的,不玩虚的。

在hash模式下,前端路由修改的是#中的信息,而浏览器请求时是不带它玩的,所以没有问题.但是在history下,你可以*的修改path,当刷新时,如果服务器中没有相应的响应或者资源,会分分钟刷出一个404来。

解决方法

前端配置

1、配置webpack

在devServer中存在historyApiFallback配置项,只需要将其设置成true就可以解决刷新404问题,如果未解决请查看是否使用了proxy代理,proxy代理需要注意不能写成以下格式(只限在使用history模式的时候):
解决Vue-routerhistory模式页面404这样写无论页面请求了什么路由地址他都会匹配到 / 仍然会去访问代理地址导致historyApiFallback配置失效!正确配置如下:解决Vue-routerhistory模式页面404

后端配置

1、基于nodejs原生

const http = require('http')
const fs = require('fs')
const httpPort = 80

http.createServer((req, res) => {
  fs.readFile('index.htm', 'utf-8', (err, content) => {
    if (err) {
      console.log('We cannot open "index.htm" file.')
    }

    res.writeHead(200, {
      'Content-Type': 'text/html; charset=utf-8'
    })

    res.end(content)
  })
}).listen(httpPort, () => {
  console.log('Server listening on: http://localhost:%s', httpPort)
})

2、基于nodejs的express

对于 Node.js/Express,请考虑使用 connect-history-api-fallback 中间件

3、nginx

location / {
  try_files $uri $uri/ /index.html;
}

4、Apache

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index\.html$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.html [L]
</IfModule>

5、Internet Information Services (IIS)

1、安装 IIS UrlRewrite
2、在你的网站根目录中创建一个 web.config 文件,内容如下:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="Handle History Mode and custom 404/500" stopProcessing="true">
          <match url="(.*)" />
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
          <action type="Rewrite" url="/" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

6、Caddy

rewrite {
    regexp .*
    to {path} /
}

7、Firebase 主机

{
  "hosting": {
    "public": "dist",
    "rewrites": [
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  }
}

警告

给个警告,因为这么做以后,你的服务器就不再返回 404 错误页面,因为对于所有路径都会返回 index.html 文件。为了避免这种情况,你应该在 Vue 应用里面覆盖所有的路由情况,然后在给出一个 404 页面。

const router = new VueRouter({
  mode: 'history',
  routes: [
    { path: '*', component: NotFoundComponent }
  ]
})

或者,如果你使用 Node.js 服务器,你可以用服务端路由匹配到来的 URL,并在没有匹配到路由的时候返回 404,以实现回退。