Version: v5.3

Vue、React项目如何调用后端接口

前言

部署 Vue 、React 项目请参考 Rainbond 部署 Vue、React 项目

以往我们在部署前端项目后，调用后端接口有以下几种场景：

后端接口没有统一，比较分散，例如：/system/user,/tool/gen 。
通常我们会在项目的全局配置文件 .env.production中直接写入后端 ip，例如：
```
ENV = 'production'
VUE_APP_BASE_API = '192.168.6.66:8080'
```
这样写虽可以正常访问，但会导致产生跨域问题。
后端接口统一，例如：/api/system/user, /api/tool/gen。
大部分小伙伴也还是同样会直接把IP + 后缀写入到项目全局配置文件，例如：
```
ENV = 'production'
VUE_APP_BASE_API = '192.168.6.66:8080/api'
```
这样写当然了也会有跨域的问题。

那我们该怎么解决接口不统一或接口统一的跨域问题呢。

答：使用Nginx 反向代理。

大部分小伙伴用 nginx 都是项目打包完的dist包丢进 nginx，配置个 location proxy_pass 反向代理后端，然后在项目全局配置里填写Nginx地址。酱紫还是会跨越哦 😋。那究竟该怎么处理呢，请往下看 👇

解决跨域对于不同的场景有以下几种方法：

接口没有统一

接口数量较少的话，比如只有几个接口system tool moitor login getmenu等。
首先需要修改全局配置文件.env.production 的请求 api 为/，酱紫写前端发起请求的时候会直接转发到 nginx。
```
ENV = 'production'
VUE_APP_BASE_API = '/'
```
其次修改Nginx配置文件，添加多个location，在浏览器请求的时候就会匹配到 nginx 的 location 规则，例如：
浏览器请求菜单：http://192.168.6.66/getmenu，会匹配 location /getmenu规则反向代理到后端。
```
server {
      listen       5000;
        #静态页面
      location / {
          root   /app/www;
          try_files $uri $uri/ /index.html;
          index  index.html index.htm;
      }

      location /getmenu{
          proxy_pass http://127.0.0.1:8080/;
      }
  }
```
这种方式固然可以，但对于接口几十个上百个一一配置很麻烦。
接口数量很多。
同样首先也需要修改全局配置文件.env.production，修改请求接口为 api，这个接口自定义的。有的小伙伴就疑问了，我没有这个接口呀，请接着往下看。
```
ENV = 'production'
VUE_APP_BASE_API = '/api'
```
紧接着修改Nginx配置文件，在 nginx 配置文件中添加了location /api，并且添加了 rewrite、proxy_pass，这个 rewrite是 URL 重写。
例如：请求 http://192.168.6.66/api/system/menu，酱紫请求正常情况发送到后端，后端会报错是没有这个接口的。
我们通过rewrite 重写 URL，此时 URL 就会变成http://192.168.6.66/system/menu并且通过proxy_pass反向代理到后端，此时发送接口请求/system/menu，后端正常返回。
```
server {
    listen       5000;

    location / {
        root   /app/www;
        try_files $uri $uri/ /index.html;
        index  index.html index.htm;
    }

    location  /api {
        rewrite ^/api/(.*)$ /$1 break;
        proxy_pass http://192.168.2.182:8080;
    }
}
```
rewrite ^/api/(.*)$ /$1 break具体可参考Nginx 官方文档 rewrite_module 模块，在这里简单介绍下：
rewrite ^/api/(.*)$ /$1 break
关键字正则替代内容 flag 标记

接口统一

对于这种就比较好处理了。

同样首先也是修改项目的全局配置文件.env.production，修改请求接口为 /prod-api。这个统一接口是后端提供的哈。

ENV = 'production'
VUE_APP_BASE_API = '/prod-api'

修改Nginx配置文件，增加一条location，反向代理到后端地址。

此时在浏览器请求的 URL 则为：http://192.168.6.66/prod-api/system/menu。

server {
    listen       5000;

    location / {
        root   /app/www;
        try_files $uri $uri/ /index.html;
        index  index.html index.htm;
    }

    location  /prod-api {
        proxy_pass http://192.168.2.182:8080;
    }
}

跨域问题解决了，那我们开始实践一次 😁。

本次前端的配置就是上面说的接口统一的方式

接下来部署一个 SpringBoot 后端项目来配合前端一起使用。

源码部署后端

本项目源码地址https://gitee.com/zhangbigqi/RuoYi-Vue.git Fork 开源项目若依
后端是SpringBoot + Mysql + Redis 架构。

Dockerfile 源码构建部署 Mysql

参考博客文章Rainbond 中用 Dockerfile 便捷构建运行应用

通过 Dockerfile 源码构建部署 Mysql。参考文档Dockerfile 源码构建
Dockerfile 源码构建需要在项目所需 Sql 目录放置Dockerfile文件自动初始化数据库。
Dockerfile 文件可参考https://gitee.com/zhangbigqi/RuoYi-Vue.git 此项目下的 sql 目录
填写源码仓库地址，填写 Mysql 子目录 sql，构建 Mysql。
确认创建组件，平台会自动识别语言为 dockerfile。
创建，等待构建组件完成即可。
构建完成后，在组件 > 端口中打开对内服务并且修改 别名，点击即可修改，改为MYSQL_HOST,以供后端连接时使用。

Docker 镜像部署 Redis

通过 docker 镜像部署 redis，具体参考官方文档docker 镜像构建
使用 redis 官方镜像，redis:latest
确认创建，平台会检测出来一些镜像信息，直接创建即可。
构建完成后，在组件 > 端口中打开对内服务。以供后端连接使用

Java 源码构建部署 SpringBoot

这里提前修改了后端项目里的配置文件 ruoyi-admin/src/main/resources/application-druid.yml连接数据库的配置，改为了环境变量连接，这里就用到了上面修改的端口别名。以及修改了ruoyi-admin/src/main/resources/application.yml文件中的连接 Redis 配置
```
# 主库数据源
  master:
      url: jdbc:mysql://${MYSQL_HOST}:${MYSQL_PORT}/ry-vue?
  redis:
      # 地址
      host: 127.0.0.1
      # 端口，默认为6379
      port: 6379
```
通过 Java 源码构建项目，具体参考官方文档JAVA 源码构建
填写源码仓库地址，构建 SpringBoot 项目。
平台会根据项目根目录的 pom.xml 文件检测是什么项目，这里检测的是多模块项目。
进入多模块构建，勾选ruoyi-admin模块，此模块是可运行的，其他模块都是依赖。具体模块功能参考若依官方文档
可修改 Maven 构建参数，无特殊要求无需修改。
确认创建，等待构建完成。
这里需要注意，平台默认使用openjdk ，此项目需要使用oraclejdk来生成前端验证码。
需要在组件 > 构建源中修改 JDK类型为自定义 JDK，填写自定义 JDK 下载路径。
自定义 JDK 下载地址：https://buildpack.oss-cn-shanghai.aliyuncs.com/jdk/jdk1.8.0.tgz

需要打开 禁用缓存按钮，防止包不一样出现奇奇怪怪的问题。构建成功后再把禁用缓存关闭，下次构建就缓存正确的包了。
修改后 保存修改。构建组件，等待构建完成，修改端口为 8080 。
进入拓扑图界面，切换为编辑模式，建立组件依赖关系。
- ruoyi-ui 连接 ruoyi-admin。
- ruoyi-admin 连接 Mysql、Redis。
更新组件ruoyi-ui ruoyi-admin，至此完成。
最终效果，拓扑图：

tuoputu

页面效果：

前言​

解决跨域对于不同的场景有以下几种方法：​

接口没有统一​

接口统一​

源码部署后端​

Dockerfile 源码构建部署 Mysql​

Docker 镜像部署 Redis​

Java 源码构建部署 SpringBoot​

前言