vue3 history模式配置及nginx服务器配置

vue的路由方式有hash模式和history模式，history模式路由看起来有好些，路由路径里没有#号，而hash模式默认是有#号的。

vue3开始默认新建的项目都是history模式，不过history模式打包后想要使用正常访问的话，需要后端服务器进行配置才可以，否则可能会出现刷新后404的问题。一般情况下，服务器端使用nginx服务器进行配置。

一、vue3 history模式配置：

vue3前端history模式配置如下，这里给一个路由route/index.js里配置的例子：

import { createRouter, createWebHistory } from 'vue-router'import HomeView from '../views/HomeView.vue'const router = createRouter({  // history模式（hash模式的话，这里是createWebHashHistory）  history: createWebHistory(import.meta.env.BASE_URL),  routes: [    {      path: '/',      name: 'home',      component: HomeView    },    {      path: '/wap/',      name: 'wap',      // route level code-splitting      // this generates a separate chunk (About.[hash].js) for this route      // which is lazy-loaded when the route is visited.      component: () => import('../views/MobileView.vue')    }  ]})export default router

vite.config.js里的路径配置，这里给一个例子：

import { fileURLToPath, URL } from 'node:url'import { defineConfig } from 'vite'import vue from '@vitejs/plugin-vue'// https://vitejs.dev/config/export default defineConfig({  //这里也可以设置为/路径  base: '/calculator',  publicDir: "public",  assets: "src/assets",  plugins: [vue()],  resolve: {    alias: {      '@': fileURLToPath(new URL('./src', import.meta.url))    }  },  build: {    assetsDir: "assets",  },})

以上例子中vite.config.js的配置，打包后访问的路径为https://xxx.com/calculator/。

配置好后，我们在开发完项目后，运行npm run build就可以打包history模式的项目了。

二、nginx服务器配置：

这里用的linux系统的nginx服务器。这里给出会用到的nginx命令：

1、判断服务器是否安装nginx，查看nginx状态；

ps -ef | grep nginx

如果出现如下图类似的运行进程，证明nginx已安装并正在运行。

2、服务器安装nginx；

如果我们的linux服务器没有安装nginx服务，可以通过以下命令安装nginx服务。

（1）安装依赖包

//一键安装上面四个依赖yum -y install gcc zlib zlib-devel pcre-devel openssl openssl-devel

（2）下载并解压安装包

//创建一个文件夹cd /usr/localmkdir nginxcd nginx//下载tar包wget http://nginx.org/download/nginx-1.13.7.tar.gztar -xvf nginx-1.13.7.tar.gz

（3）安装nginx

//进入nginx目录cd /usr/local/nginx//进入目录cd nginx-1.13.7//执行命令 考虑到后续安装ssl证书 添加两个模块./configure --with-http_stub_status_module --with-http_ssl_module//执行make命令make//执行make install命令make install

（4）启动nginx

/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf//或者nginx -c /usr/local/nginx/conf/nginx.conf 

3、查看nginx版本号；

//直接使用nginx命令时，是已经切换到nginx/sbin/nginx目录nginx -v//或者/usr/local/nginx/sbin/nginx -v

4、nignx配置；

# 打开配置文件vi /usr/local/nginx/conf/nginx.conf//或者用ftp下载nginx.conf下来后进行编辑

这里给一个简单的监听一个域名端口的nginx.conf配置文件：

server{    listen 80;listen 443 ssl http2;    server_name abc.xxx.com;    index index.php index.html index.htm default.php default.htm default.html;    root /www/wwwroot/abc.xxx.com;        #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则    #error_page 404/404.html;    ssl_certificate    /etc/letsencrypt/live/abc.xxx.com/fullchain.pem;    ssl_certificate_key    /etc/letsencrypt/live/abc.xxx.com/privkey.pem;    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;    ssl_prefer_server_ciphers on;    ssl_session_cache shared:SSL:10m;    ssl_session_timeout 10m;    error_page 497  https://$host$request_uri;    #SSL-END        #ERROR-PAGE-START  错误页配置，可以注释、删除或修改    error_page 404 /404.html;    error_page 502 /502.html;    #ERROR-PAGE-END        #PHP-INFO-START  PHP引用配置，可以注释或修改    include enable-php-00.conf;    #PHP-INFO-END        #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效    include /www/server/panel/vhost/rewrite/abc.xxx.com.conf;    #REWRITE-END        #禁止访问的文件或目录    location ~ ^/(\.user.ini|\.htaccess|\.git|\.svn|\.project|LICENSE|README.md)    {        return 404;    }        #一键申请SSL证书验证目录相关设置    location ~ \.well-known{        allow all;    }        location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$    {        expires      30d;        error_log off;        access_log off;    }        location ~ .*\.(js|css)?$    {        expires      12h;        error_log off;        access_log off;     }    #vue3 history模式站点目录配置    location /calculator {      try_files $uri $uri/ /calculator/index.html;    }    access_log  /www/wwwlogs/abc.xxx.com.log;    error_log  /www/wwwlogs/abc.xxx.com.error.log;}

5、检测nignx配置是否正确；

./nginx -t//或者nginx -t

 出现如上图所示test is successful表示配置文件正确。

6、重启nginx服务。
配置文件编写或者更改后，需要重启nginx服务才能生效。

nginx -s reload

这样，我们通过访问https://abc.xxx.com/calculator/或者https://abc.xxx.com/calculator/wap/这个路径就可以正常使用了，刷新也不会出现404问题。

三、宝塔nginx配置文件路径

如果我们是通过宝塔系统建站配置的，那么更加的方便，都是可视化操作配置。

宝塔面板站点Nginx配置文件nginx.conf路径位置放在：/www/server/panel/vhost/nginx/xxx.com.info.conf下。

来源地址：https://blog.csdn.net/jay100500/article/details/130072520