矣道晒秃一、概述
uni-app x 提供了 uni.request() 方法。
uni.request({
url: 'https://api.example.com',
method: 'GET'
})
在实际项目开发中，直接使用 uni.request 会带来诸多问题，例如：
重复代码多（如每次都要写 baseURL）
错误处理分散，难以统一管理
缺乏请求/响应拦截能力
Token 注入繁琐
Loading 状态管理混乱
为了解决这些问题，封装一个统一的 HTTP 请求库是企业级开发的最佳实践。
二、封装request
uview-plus 自带一个 http 模块，但是在实际项目中，还是要自己封装一个，统一管理。
在项目根目录创建utils目录，在里面创建request.ts。 注意：文件后缀必须是ts，而不是js
复制代码
// utils/request.ts
import { http } from 'uview-plus'
/* 1. 全局配置 */
http.setConfig((config) => {
config.baseURL = 'https://api.example.com' // api地址
config.timeout = 8000 // 单位毫秒，对应8秒
config.loadingText = '加载中...'
config.loading = true // 开启 loading 动画
return config
})
/* 2. 请求拦截 */
http.interceptors.request.use((config) => {
const token = uni.getStorageSync('token')
if (token) config.header.Authorization = `Bearer ${token}`
return config
})
/* 3. 响应拦截 */
http.interceptors.response.use(
(response) => response.data,
(err) => {
// ?? 强制断言，让 UTS 闭嘴
(uni as any).$u.toast(err.message || '网络错误')
return Promise.reject(err)
}
)
export default http
复制代码
修改 main.uts，引入 request，并挂载为全局属性$http
复制代码
import App from './App.uvue'
import { createSSRApp } from 'vue'
import uviewPlus from 'uview-plus'
/* 1. 引入 request（里面已经初始化好 http） */
import http from '@/utils/request'
export function createApp() {
const app = createSSRApp(App)
/* 2. 挂到全局属性 */
app.config.globalProperties.$http = http
app.use(uviewPlus)
return {
app
}
}
复制代码
三、使用request
由于在main.uts挂载了全局属性，因此在pages里面的uvue文件，就可以直接调用了。比如：
get请求
const res = await this.$http.get('/test', {})
post请求
const res = await this.$http.post('/login', {
username: 'admin',
password: 123456
})
post请求，增加成功和失败处理
复制代码
async login() {
try {
/* === 成功分支 === */
const res = await this.$http.post('/login', {
username: 'admin',
password: '123456'
})
// 这里只写"成功后的业务"
uni.setStorageSync('token', res.token)
this.$u.toast('登录成功')
uni.switchTab({ url: '/pages/index/index' })
} catch (err: any) {
/* === 失败分支 === */
// 拦截器已弹通用提示，这里可做"额外"处理
console.error('登录失败', err)
if (err.statusCode === 401) {
this.$u.toast('账号或密码错误')
}
}
}
复制代码
post请求，局部请求不想显示 loading
await this.$http.post('/log', data, { loading: false })
uview-plus 的 http 模块已经内置了 "请求开始自动显示 loading，响应结束自动隐藏" 的机制，
你只需要 把 loading 开关打开 即可，成功/失败/超时都会 统一自动关闭，无需手动处理。
效果：
调用 this.$http.get/post 瞬间 → 出现 uview-plus 的 loading 遮罩
请求 成功/失败/超时 → 遮罩 自动消失（由 uview 内部 finally 关闭）
无需自己 uni.showLoading() / uni.hideLoading()
post请求，增加header
复制代码
await this.$http.post('/upload', body, {
header: {
'Content-Type': 'application/x-wwwz-form-urlencoded',
'X-Custom': 'abc123'
}
})
复制代码
put请求
const res = await this.$http.put('/test', {id:1})
delete请求
const res = await this.$http.delete('/test', {id:1})
四、登录页面
login.uvue
复制代码
复制代码
效果如下：
image
针对大型项目，可以在utils里面新建一个api.ts，用来编写一些公用业务函数，例如：
复制代码
import http from './request.js'
/* 登录 */
export const login = (username, pwd) =>
http.post('/login', { username, pwd })
/* 轮播图 */
export const getBanner = () =>
http.get('/banner')
/* 商品列表 */
export const getGoods = (params) =>
http.get('/goods', { params })
复制代码
然后在pages里面的页面，就可以调用了，无需重复写函数。
复制代码
复制代码
注意：直接调用，要用异步，函数名前面加async