uni-app怎么调用RESTful API接口

千辰大大_1651

千辰大大_1651

2026-11-18

702人浏览

原创

uni.request可直接调用RESTful API,但需手动处理HTTP方法、Header、参数序列化及错误边界;GET参数拼URL,POST数据放data并设Content-Type;非GET/POST方法需后端配置CORS;uni.uploadFile的Authorization头在iOS等平台被忽略,应改用URL传token或临时凭证;跨端时需统一用complete回调,按statusCode和业务code判断成败。

uni-app怎么调用restful api接口

直接用 uni.request 就能调用标准 RESTful API,不需要额外封装或转译——但必须手动处理 HTTP 方法、Header、参数序列化和错误边界,否则在小程序真机或不同平台(如 H5 / App)上容易静默失败。

uni.request 调用 GET/POST 时参数传错最常见

GET 请求的 query 参数必须拼在 URL 后,不能塞进 data;POST 的 body 才走 data。很多人把 token 放 data 里,结果服务端根本收不到认证头。

  • GET 示例:uni.request({ url: 'https://api.example.com/users?id=123', method: 'GET' })
  • POST 示例(JSON):uni.request({ url: 'https://api.example.com/users', method: 'POST', header: { 'Content-Type': 'application/json' }, data: { name: '张三', email: 'z@example.com' } })
  • 如果后端要求表单格式,header 改成 { 'Content-Type': 'application/x-www-form-urlencoded' },且 data 必须是字符串(可用 Object.keys(data).map(k => `${k}=${encodeURIComponent(data[k])}`).join('&') 手动序列化)

PUT/PATCH/DELETE 等方法在微信小程序里默认不支持跨域预检

微信小程序对非 GET/POST 方法会自动发 OPTIONS 预检请求,但很多后端没配 CORS 响应头(尤其是 Access-Control-Allow-Methods 和 Access-Control-Allow-Headers),导致请求卡在预检阶段,控制台只报“fail”,不显示具体错误。

  • 检查后端是否返回了 Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE
  • 确保 Access-Control-Allow-Headers 包含你实际用的字段,比如 Authorization、Content-Type
  • 开发期可临时加 @CrossOrigin(origins = "*")(Spring Boot)或 Nginx 添加对应 header,上线务必收紧 origin

uni.uploadFile 上传文件时 Authorization 头被忽略

小程序的 uni.uploadFile 在 iOS 和部分安卓版本中,会丢弃自定义 header 中的 Authorization 字段——这是平台限制,不是 bug。token 只能换种方式传。

uni-app
uni-app

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

下载
  • 改用 URL 参数传 token:url: 'https://api.example.com/upload?token=xxx'
  • 或后端改用 Cookie 认证(需服务端开启 withCredentials: true 并配置 Access-Control-Allow-Credentials: true)
  • 更安全的做法是:前端先 uni.request 换一个临时上传凭证(如阿里云 STS Token),再把凭证塞进 uni.uploadFile 的 formData 里

跨端时 uni.request 的 success/fail 行为不一致

H5 环境下 fail 只在网络断开或超时时触发;而小程序里,HTTP 状态码 401/500 也会进 fail,且 res.statusCode 在 H5 下可能不存在。靠 success 判断接口是否“成功”极易漏掉业务错误。

  • 统一用 complete 回调做 loading 隐藏等公共操作
  • 所有业务逻辑写在 success 里,但必须检查 res.statusCode 是否为 200~299
  • 对非 2xx 响应,手动抛错或走错误处理分支,别依赖 fail 捕获
  • 建议封装一层:判断 res.statusCode + 解析 res.data 中的业务 code 字段(如 res.data.code !== 0)才视为真正失败

真正麻烦的从来不是“能不能发出去”,而是各端对状态码、header、重定向、超时的隐式处理差异——每次换平台都要重新验证一遍响应路径,别信文档里写的“完全支持”。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

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

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

下载

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

相关专题

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

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

2023.08.11

3063

5

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

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

2023.10.09

6743

6

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

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

2024.03.19

7570

13

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

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

2024.03.22

7518

10

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

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

2024.05.22

1063

5

PHP API接口开发与RESTful实践
PHP API接口开发与RESTful实践

本专题聚焦 PHP在API接口开发中的应用,系统讲解 RESTful 架构设计原则、路由处理、请求参数解析、JSON数据返回、身份验证(Token/JWT)、跨域处理以及接口调试与异常处理。通过实战案例(如用户管理系统、商品信息接口服务),帮助开发者掌握 PHP构建高效、可维护的RESTful API服务能力。

2025.11.26

584

16

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.09

4163

4

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

2023.11.14

1014

3

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

2024.03.12

6946

8

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习