更新记录

1.0.0（2026-07-08） 下载此版本

基于uni.request封装的UTS网络请求插件，支持GET/POST/PUT/DELETE/文件上传

平台兼容性

uni-app x(4.87)

wp-request

基于 uni.request 封装的 UTS 网络请求插件，支持 GET/POST/PUT/DELETE 及文件上传，适用于 uni-app x 项目。

快速开始

1. 创建请求初始化文件

在项目中创建 utils/request/index.uts，统一初始化配置并导出便捷方法：

import { WpRequest } from '@/uni_modules/wp-request'
import { BASE_URL, BASE_API } from '@/config/env'
import { WpStorage } from '@/uni_modules/wp-storage'
import { showTips } from '@/utils/uniTool'

WpRequest.create({
  baseUrl: BASE_URL + BASE_API,
  timeout: 120000,
  tokenProvider: () : string | null => {
    return WpStorage.getToken()
  },
  onUnauthorized: () : void => {
    uni.reLaunch({ url: '/pages/login/index' })
  },
  onError: (msg : string) : void => {
    showTips({ title: msg.length > 0 ? msg : '请求失败' })
  }
})

export const get = WpRequest.get
export const post = WpRequest.post
export const put = WpRequest.put
export const del = WpRequest.delete
export const uploadFile = WpRequest.uploadFile
export const request = WpRequest.request

2. 在 API 文件中使用

import { get, post } from '@/utils/request'

export function bannerListAPI() : Promise<UTSJSONObject> {
  return get('/app/banner/list').then((res) => res.data)
}

export function goodsDetailAPI(params : UTSJSONObject = {} as UTSJSONObject) : Promise<UTSJSONObject> {
  return get('/app/goods/detail', params).then((res) => res.data)
}

export function createOrderAPI(params : UTSJSONObject = {} as UTSJSONObject) : Promise<UTSJSONObject> {
  return post('/app/order/create', params).then((res) => res.data)
}

插件直接使用

也可以直接引入插件：

import { WpRequest } from "@/uni_modules/wp-request"

初始化配置（WpRequestConfig）

请求方法

GET

const res = await get('/user/info')
const res = await get('/user/list', { page: 1 } as UTSJSONObject)
const res = await get('/user/info', null, { 'X-Custom': 'val' } as UTSJSONObject)

POST

const res = await post('/order/create', { itemId: 123 } as UTSJSONObject)

PUT

const res = await put('/user/update', { nickname: '新名称' } as UTSJSONObject)

DELETE

const res = await del('/order/cancel', { orderId: 456 } as UTSJSONObject)

通用请求

const res = await request({
  url: '/user/info',
  method: 'GET',
  data: { id: 1 } as UTSJSONObject,
  header: { 'X-Token': 'xxx' } as UTSJSONObject,
  timeout: 30000
})

WpRequestOptions

文件上传

const res = await uploadFile({
  url: '/file/upload',
  filePath: '/path/to/file.jpg',
  name: 'file',
  formData: { type: 'avatar' } as UTSJSONObject
})

WpUploadOptions

响应格式（WpResponse）

动态修改配置

WpRequest.setConfig({
  baseUrl: 'https://new-api.example.com/v2',
  timeout: 60000
})

Token 自动注入

配置 tokenProvider 后，每次请求自动调用该函数获取 Token 并添加到请求头：

WpRequest.create({
  baseUrl: 'https://api.example.com',
  tokenProvider: () => uni.getStorageSync('access_token') as string | null
})

请求头自动添加：Authorization: Bearer <token>

自定义前缀或无前缀：

tokenPrefix: ''       // Authorization: <token>
tokenPrefix: 'Token'  // Authorization: Token <token>

错误码

支持平台

• Android
• iOS
• HarmonyOS

开发文档

UTS 语法

UTS API插件