uni-app怎么配置跨域代理

陌墨姑娘_1472

陌墨姑娘_1472

2026-11-21

731人浏览

原创

manifest.json代理配置优先级更高,因其是uni-app官方原生支持的配置入口,HBuilderX和CLI工具优先读取并完全覆盖vue.config.js中的同名配置。

uni-app怎么配置跨域代理

直接在 manifest.json 里配 h5.devServer.proxy,比写 vue.config.js 更稳、更优先、不用额外装依赖。

为什么 manifest.json 代理配置优先级更高

uni-app 构建流程中,manifest.json 是官方原生支持的配置入口,HBuilderX 和 CLI 工具都会优先读取它里面的 h5.devServer 配置。如果同时存在 vue.config.js 和 manifest.json 的代理设置,后者会完全覆盖前者 —— 这不是 bug,是设计如此。

常见踩坑点:

  • 改了 vue.config.js 没生效?先检查 manifest.json 是否已有同路径的 proxy 配置
  • 在 HBuilderX 可视化界面改过 H5 设置后,manifest.json 会自动生成 h5 节点,但默认不含 devServer,需手动补全
  • manifest.json 是 JSON 格式,不能写注释、不能用单引号、不能有尾逗号,否则启动报错:Invalid JSON in manifest.json

manifest.json 中 proxy 的关键参数怎么填

以代理 /api 到 https://api.example.com 为例,完整片段如下:

{
  "name": "my-app",
  "appid": "",
  "description": "",
  "versionName": "1.0.0",
  "versionCode": "100",
  "transformPx": true,
  "app-plus": { /* ... */ },
  "h5": {
    "devServer": {
      "disableHostCheck": true,
      "proxy": {
        "/api": {
          "target": "https://api.example.com",
          "changeOrigin": true,
          "secure": false,
          "pathRewrite": {
            "^/api": ""
          }
        }
      }
    }
  }
}

各参数作用:

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • disableHostCheck: true:允许非 localhost 域名访问开发服务器(真机调试必备)
  • target:必须带协议(http:// 或 https://),不能只写域名
  • changeOrigin: true:重写请求头中的 Host 字段为目标地址,否则某些后端(如 Nginx、Spring Boot)会拒绝请求
  • secure: false:当 target 是 HTTPS 且证书不合法(如自签名)时,必须设为 false,否则连接被拒绝
  • pathRewrite:正则替换路径前缀,"^/api" 必须加 ^ 锚定开头,否则可能误删部分路径

多个 API 域名要代理,怎么写

直接在 proxy 对象下并列写多个键,互不干扰:

"proxy": {
  "/user-api": {
    "target": "https://user-service.example.com",
    "changeOrigin": true,
    "secure": false,
    "pathRewrite": { "^/user-api": "" }
  },
  "/order-api": {
    "target": "https://order-service.example.com",
    "changeOrigin": true,
    "secure": false,
    "pathRewrite": { "^/order-api": "" }
  }
}

注意:

  • 路径前缀不能重叠,比如不能同时有 "/api" 和 "/api/v1",后者会被前者提前匹配
  • 如果后端接口本身带路径(如 https://api.com/v2/),target 就得写全,pathRewrite 仅处理前端发出的请求路径
  • WebSocket 代理需要额外加 "ws": true,且 target 必须是 ws:// 或 wss://

最易忽略的是:改完 manifest.json 后必须**重启开发服务**(关掉再 npm run dev:h5 或点击 HBuilderX 的「运行」按钮),热更新不会重新加载代理配置。另外,生产环境打包后的 H5 不走 devServer,代理配置完全无效 —— 上线前务必确认后端已配好 CORS 或使用 Nginx 反向代理。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3143

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6883

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7690

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7678

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1083

5

TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

2026.02.13

332

17

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

2026.02.25

560

17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

2026.03.13

431

19

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

2026.06.03

346

29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习