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.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 只能换种方式传。
- 改用 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应用能力赋能!











