使用Nginx解决VUE本地开发调用外部接口跨域的问题

前端开发调用后台接口常遇跨域问题,设置Chrome浏览器禁用安全模式虽可行,但操作较麻烦。本文介绍用Nginx的反向代理机制解决跨域,通过在nginx.conf文件添加代码,重启Nginx,可避免跨域问题,且不限于Chrome浏览器。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

前端开发需要调用后台接口时经常遇到跨域的问题,一般是设置Chrome浏览器禁用安全模式,
在启动chrome命令后面加 --disable-web-security,最新的版本可能还需要加一个本地的存放chrome配置的文件夹,如下,
--user-data-dir=C:\MyChromeDevUserData

这种方式很不错,唯一的缺点就是有时候如果不是这种方式打开的Chrome,页面要进行跨域调试时需要关闭浏览器再用上边那种方式打开才行,这时如果已经打开了一堆网页可能就比较麻烦了。


现在介绍使用Nginx的方向代理机制来解决浏览器跨域的问题

首先假设前端VUE的端口是8080, 要调用的后台接口是:http://192.168.1.111:9090/mydemo/api/getList

因为浏览器的同源策略,所以这样必然产生了跨域。

由于VUE已经占用了前端的端口8080了,所以我们用Nginx只能再设置一个新的端口,这里暂定:8888

在nginx.conf文件 http{} 块里,添加下面的代码:

    server {
        listen  8888;
        server_name  localhost;

        location ^~/mydemo/ {
            rewrite ^/(.*)$ /$1 break;
            proxy_pass http://192.168.1.111:9090/mydemo/;
        }

        location / {
            proxy_pass http://127.0.0.1:8080;
        }
    }

location ^~/mydemo/ 一定要放在 location / 前面,这样所有访问后台的请求才会走这块的代理。 一般后台服务都会带着项目名,例如mydemo,或者加上固定的url路径前缀,主要是为了跟前端静态资源区分开来。

重启Nginx,访问 http://localhost:8888 即可。
这样就完全避免了跨域的问题,而且不限于Chrome了,使用IE、Firefox同样没有问题。

### 封装 Axios 并实现请求 #### 创建 Axios 实例并设置默认配置 为了更好地管理和维护 HTTP 请求,在 `src/utils` 文件夹下创建名为 `http.ts` 的文件来封装 Axios。通过这种方式可以集中处理全局配置,如基础 URL 和拦截器。 ```typescript // src/utils/http.ts import axios, { AxiosInstance, AxiosRequestConfig } from 'axios'; const service: AxiosInstance = axios.create({ baseURL: process.env.VUE_APP_BASE_API, timeout: 5000 // request timeout }); service.interceptors.request.use( (config: AxiosRequestConfig) => { const token = localStorage.getItem('token'); if (token && config.headers) { config.headers['Authorization'] = `Bearer ${token}`; } return config; }, error => Promise.reject(error) ); export default service; ``` 此部分代码定义了一个带有预设选项的新 Axios 实例,并设置了请求前缀路径以及超时时间[^1]。 #### 处理 API 接口管理 按照模块化思路设计API接口层结构,即在 `src/api` 下按功能划分不同子目录存放各自业务逻辑对应的接口函数。例如: ```plaintext ├── api/ │ ├── user.ts # 用户相关接口 │ └── product.ts # 商品相关接口 └── utils/ └── http.ts # Axios实例和服务端交互工具类 ``` 对于具体的接口调用,则可以在相应的 `.ts` 文件内编写如下所示的方法: ```typescript // src/api/user.ts import service from '@/utils/http'; export function getUserInfo(params?: any): Promise<any> { return service.get('/user/info', { params }); } ``` 上述例子展示了如何利用之前建立好的 Axios 实例发起 GET 类型的数据获取操作[^3]。 #### 配置 Vite 开发环境下的代理服务器以解决开发阶段的 CORS 错误 由于浏览器同源策略限制,默认情况下前端应用无法直接向不同的名发送 AJAX 请求。为此可以通过修改构建工具(这里是Vite)的相关配置项来绕过这一障碍。编辑项目的根目录中的 `vite.config.ts` 或者 `vite.config.js` 添加代理规则: ```javascript // vite.config.ts or vite.config.js import { defineConfig } from 'vite'; import vue from '@vitejs/plugin-vue'; export default defineConfig({ plugins: [vue()], server: { proxy: { '/api': { target: 'https://example.com', changeOrigin: true, rewrite: path => path.replace(/^\/api/, '') } } } }); ``` 这段配置使得当访问 `/api/*` 路径时会被转发到指定的目标地址上执行实际的服务端程序[^4]。 #### 生产环境中部署反向代理服务 除了开发期间借助本地代理外,在生产环境下通常还需要依靠 Nginx 等 Web Server 来完成正式上线后的资源共享(CORS)支持工作。这涉及到调整后端应用程序的安全性和权限控制机制,确保只允许来自特定来源的应用能够成功读取资源数据。
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值