使用Tomcat和Nginx部署前端项目

前言

最近做了一个前后端分离的项目，项目完成后使用Tomcat和Nginx来部署前端项目。下面会对部署步骤和需要注意的一些坑进行讲解。如果你在部署前端项目上存在疑惑，希望这篇文章能够给你提供帮助。

部署方式一：Tomcat做Web服务器

第一种方式，将我们的前端项目放置在webapps目录下

放置好后回到tomcat的bin目录下，执行./startup.sh，并在网页上查看，会发现这个时候相关的页面并没有展示出来，这是因为tomcat对静态资源的读取是默认从根目录开始的。正确的路径应该是ip地址:8080/music_client/static/...
'
解决这个问题有两种方式：

1. 使用虚拟路径

进入tomcat安装路径下的conf目录，在server.xml文件中<Host>标签内配置虚拟路径

<Context path="/static" docBase="music_client/static" reloadable="true"></Context>

简单的解释一下参数
path对应用户请求过来的url路径, /static匹配所有以/static开头的请求
docBase表示实际匹配到的路径，这里可以使用绝对路径，也可以使用相对路径
reloadable 如果为true，则tomcat会自动检测应用程序的/WEB-INF/lib 和/WEB-INF/classes目录的变化。（对于静态资源来说，个人觉得这个配置用处不大）
总结起来就是，对于ip:8080/static的资源请求，会通过虚拟路径匹配到我们实际的资源路径music_client/static。
配置好后重启，我们可以发现已经能够看到我们的前端项目了

2. 将项目直接放置在webapps/ROOT目录下

对于ROOT目录下的资源，tomcat可以直接在根目录下进行访问。通过这种方式，我们可以让项目的路径去适配tomcat访问的路径。
但是这种方式不是特别推荐，当有多个项目在同一个tomcat服务器上的时候，会不方便管理。

部署方式二：直接用Nginx做Web服务器

Nginx是当下热门的服务器，使用起来只需要进行简单的配置即可。对于Nginx的安装大家可以自行百度解决。
我们先进入到usr/local/nginx（具体以实际nginx安装目录为准）下的conf目录，vim编辑nginx.xml。主要进行下面的配置

 server {
        listen       8082;
        server_name  localhost;
        location / {
            root   /usr/local/music_site/music_client/;
            index  index.html index.htm;
            try_files $uri  /index.html;

        }
}

简单的解释一下
listen 表示nginx监听的端口号，也就是你希望暴露哪个端口给用户进行访问
server_name 表示nginx接受请求的域名，一般默认localhost就行
location 模块用于响应请求，这里的 / 表示匹配8082端口的所有请求
root 表示静态资源/项目的路径
index 表示默认的访问资源
配置完成后，进入sbin目录下，通过./nginx -t 检查配置文件的格式是否正确
如正确 ./nginx进行启动或者 ./nginx -s reload进行重启
启动完，我们就可以直接ip:8082直接访问我们的前端项目啦

部署方式三：Tomcat做Web服务器，Nginx做反向代理服务器

开启nginx的反向代理也比较简单，只需要加上proxy_pass 配置即可

server {
        listen       8082;
        server_name  localhost;

        location / {
             proxy_pass   http://localhost:8080/music_client/;
            index  index.html index.htm;
            try_files $uri  /index.html;

        }

其他可能遇到的坑！！

（一） 路由模式为history时，直接访问url路径出现404问题

出现这个问题的原因是：在history模式下，只是动态的通过js操作window.history来改变浏览器地址栏里的路径，并没有发起http请求，但是当我们直接在浏览器输入这个地址的时候，就会对服务器发起http请求，但是这个目标在服务器上又不存在，所以会返回404。
我们可以通过把所有请求都转发到首页上来解决这个问题。只需要在Nignx中的配置文件加入如下配置：

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

事实上，上面的解决方式也是Vue-Router官方推荐的解决方式（https://router.vuejs.org/zh/guide/essentials/history-mode.html#nginx）。
那上面的try_files为什么能帮助我们解决这个问题呢？我们可以看一下这个属性的作用

try_files：按选项所指定的顺序去检查用户请求的文件是否存在，如果本地存在的话则返回该请求；不存在的话将该请求转发到指定的其它路径。也就是说，比如我们当前的前端项目部署在/usr/myproj目录下，现在我们在浏览器发起ip:port/testApi请求，那么此时uri为testApi,nginx会先去$root/testApi（即/usr/local/myproj/testApi）找是否存在该静态资源，若不存在，则继续寻找$root/testApi/index（即/usr/local/myproj/testApi/index）文件是否存在，如果还是不存在，则会把请求转发到首页。

location / {
  root  /usr/local/myproj;
  index  index.html index.htm;
  try_files $uri $uri/ /index.html;
}

而我们的项目本事就是由Vue-Cli创建的单页面应用，当index页面接收到请求的时候，对应的history模式路由就可以发挥作用了，根据浏览器的路由跳转到对应的页面，这也就保证了我们的路由请求都能够转发给index页面来进行处理。

（二） Nginx缺少SSL模块，配置反向代理到 https的网站时报错

这种问题一般是出现在服务器一开始安装Nginx的时候，没有安装SSL模块。在不重装Nignx的情况下，可以安装如下方式进行操作：

步骤1：停掉本地正常运行的Nginx（如果没有运行，则可以跳过这一步）

步骤2：进入到/usr/local/nginx/nginx-版本号（具体看你nginx当时的解压路径）

执行如下命令

./configure --prefix=/usr/local/nginx --with-http_ssl_module

步骤3：继续执行make命令

make

步骤4：备份一下原有的nginx配置

这一步只是以防万一，可以省略

cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak

步骤5：把刚才编译的nginx 拷贝覆盖原来的nginx

cp ./objs/nginx /usr/local/nginx/sbin/

步骤6：执行一下nginx -V 检测是否安装成功

也可以直接执行./usr/local/nginx/sbin/nginx -t看还会不会报错就行

./usr/local/nginx/sbin/nginx -V

参考文章：

nginx报错: [emerg] https protocol requires SSL support in /usr/local/nginx/conf/nginx.conf:50