在nginx上部署vue项目(history模式)；

时间：2022-04-10 07:48:14

在nginx上部署vue项目(history模式)；

vue-router 默认是hash模式，使用url的hash来模拟一个完整的url，当url改变的时候，页面不会重新加载。但是如果我们不想hash这种以#号结尾的路径时候的话，我们可以使用路由的history的模式。比如如下网址：
使用hash模式的话，那么访问变成 http://localhost:8080/bank/page/count/#/ 这样的访问，如果路由使用 history的话，那么访问的路径变成 如下：
http://localhost:8080/bank/page/count 这样的了；

在路由的配置就是如下：我们还是以 vue-cli项目为例：
在src/router/index.js 代码如下：

import Vue from 'vue';

import Router from 'vue-router';

// import HelloWorld from '@/views/HelloWorld';

Vue.use(Router);

const router = new Router({

  mode: 'history', // 访问路径不带井号  需要使用 history模式

  base: '/bank/page',  // 基础路径

  routes: [

    {

      path: '/count',

      name: 'count',

      component: resolve => require(['@/views/count'], resolve) // 使用懒加载

    }

  ]

});

不过history的这种模式需要后台配置支持。比如：
当我们进行项目的主页的时候，一切正常，可以访问，但是当我们刷新页面或者直接访问路径的时候就会返回404，那是因为在history模式下，只是动态的通过js操作window.history来改变浏览器地址栏里的路径，并没有发起http请求，但是当我直接在浏览器里输入这个地址的时候，就一定要对服务器发起http请求，但是这个目标在服务器上又不存在，所以会返回404，怎么解决呢？我们现在可以把所有请求都转发到 http://localhost:8080/bank/page/index.html上就可以了。

一： apache服务器上的配置如下：

1. 如果我们现在是使用apache做web服务器的话，我们需要开启 .htaccess支持即可：
在文件里加上如下，就一切正常了

<IfModule mod_rewrite.c>

  RewriteEngine On

  RewriteBase /

  RewriteRule ^index\.html$ - [L]

  RewriteCond %{REQUEST_FILENAME} !-f

  RewriteCond %{REQUEST_FILENAME} !-d

  RewriteRule . /bank/page/index.html [L]

</IfModule>

上面的apache的作用是：把所有服务器上不存在的请求全部转发到 index.html上去，这样就可以直接通过各种url来访问了。

注意：
1. RewriteRule . /bank/page/index.html [L] 这段代码；前面需要加 /bank/page/这样的，因为我在路由配置base里面
加了 /bank/page/ 这个路径，否则匹配不到了。

2. vue-cli 项目中需要修改 config/index.js 中的build下的 assetsPublicPath: '/bank/page/', 如果使用相对路径，
chunk文件会报错找不到。

3. 在apache的 www/bank/page 目录下新建 .htaccess文件，需要修改RewriteRule 为/bank/page/index.html, 否则刷新页面服务端会直接报404错误。

4. 修改httpd.conf文件，开启rewrite_module功能。

5. LoadModule rewrite_module libexec/apache2/mod_rewrite.so，去掉前面的#

6. 然后找到AllowOverride None的那行，把它改成AllowOverride All，来使.htaccess文件生效。

二：nginx服务器上的配置如下：

vue-cli 执行打包命令：
npm run build

如上进行打包，生成dist文件夹，把该文件夹下的文件直接复制到nginx服务器目录下，就可打开项目，但是只有首页可以看到的，刷新一下页面也是404了，原因和上面一样，因此需要在nginx服务器配置对所有的路径或者文件夹进行跳转，重定向到首页 index.html即可：这样就能找到路由了。
nginx服务器配置如下：

1. 首先登录服务器。
2. 进入目录 /etc/usr/local/nginx/conf/下;
执行命令：
   2-1 cd /etc/ 回车
   2-2 cd /usr/ 回车
   2-3 cd loacl/ 回车
   2-4 cd nginx 回车
   2-5 cd conf 回车
   2-6 vi nginx_v4.conf 进入 nginx文件内 新建一个项目的相关配置如下：

比如我们现在的域名地址这样访问的：http://aa.xx.com/bank/page/count , 需要如下配置：

server {

    listen 443;     # 监听本机所有ip上的 443 端口

    listen 80;      # 监听本机所有ip上的 80 端口

    server_name  aa.xx.com; # 域名地址

    access_log  /data/www/logs/nginx/aa/access.log main; # 新建日志文件

    include nginx_xx.conf;

    /* 下面是多个location 用于配置路由地址 */

    location / {

      proxy_pass http://aa/;

      include nginx_proxy.conf;

    }

    location /bank/page/ {

      try_files $uri $uri/ /bank;

    },

    /* http://aa.xx.com/bank2/page/count 有多个不同的地址 就加一个如下这个配置 */

    location /bank2/page/ {

      try_files $uri $uri/ /bank2;

    }

    error_page  500 502 503 504  /502.html;

    location = /50x.html {

      root   html;

    }

  }

try_files 指令：

语法：try_files file ... uri 或 try_files file ... = code
默认值：无
作用域：server location

其作用是按顺序检查文件是否存在，返回第一个找到的文件或文件夹（结尾加斜线表示为文件夹），如果所有的文件或文件夹都找不到，会进行一个内部重定向到最后一个参数。

需要注意的是，只有最后一个参数可以引起一个内部重定向，之前的参数只设置内部URI的指向。最后一个参数是回退URI且必须存在，否则会出现内部500错误。命名的location也可以使用在最后一个参数中。与rewrite指令不同，如果回退URI不是命名的location那么$args不会自动保留，如果你想保留$args，则必须明确声明。

location指令
语法：location [=|~|~*|^~|@] /uri/ { … }
默认值：无
作用域：server

location指令是用来为匹配的URI进行配置，URI即语法中的"/uri/"，可以是字符串或正则表达式。但如果要使用正则表达式，则必须指定前缀。 [@] 即是命名location，一般只用于内部重定向请求。

3. 设置成功后需要重启：nginx重启命令；在 /etc/usr/local/nginx/conf/ 目录下, cd ../ 然后进入sbin目录下 cd sbin 接着运行命令 ./nginx -s reload 重启后即可生效。

4. 在/data/www/logs/nginx/aa/目录下 新建 access.log 文件。
然后nginx保存和退出命令 :wq
直接退出的命令是 :q

5. mac系统下 自带 apache2服务器，需要对apache2作反向代理；配置如下：
进入本地mac apache2配置；
命令：cd /etc/apache2
命令：sudo vi httpd.conf

<VirtualHost *:80>

  ServerName aa.xx.com

  ProxyRequests off

  Header set Access-Control-Allow-Origin *

  <Proxy *>

      Order deny,allow

      Allow from all

  </Proxy>

  <Location /aa>

      ProxyPass http://localhost:8896/

      ProxyPassReverse http://localhost:8896/

  </Location>

  // .... 更多配置省略

</VirtualHost>

然后进入 sbin目录下 启动服务 sudo apachectl start
重启命令如下 sudo apachectl restart

6. java服务端的配置如下（如果是vm放到开发那边的话，开发那边需要如下处理下，如果页面vm不放在开发那边的话，下面的配置可以忽略）
在项目目录下 webapp/web-inf/view/ 新建文件夹 aa 和 include文件
aa文件下 新建index.vm
如下代码：
#parse("include/common.vm")
#@frame("xx管理",true)
#css(["${version}/business/aa/aa.css"]) // 打包后的css路径，具体看自己的路径
<div id="app"></div>
#js(["${version}/business/aa/aa.js"]) // 打包后的js路径，具体看自己的路径
#end

6-2 java开发需要配置一下：
1 设置路由： /aa 设置路由到 /aa/index.vm
2 这个include/common.vm有一个地址配置，是在disconf上配置的，你加一个
地址配置到 //aa.xx.com/aa/dist 上即可

相关文章