Uni-app企业级网络请求封装实战

今天我们就来聊聊 Uni-app 项目的底层基石------网络请求(Request)的深度封装。

在实际开发中,直接在页面里写 uni.request 是大忌。如果接口有一百个,当你需要统一在 Header 加一个 token 或者处理登录过期时,你会写到崩溃。


🚀 今日份:企业级 Request 请求层封装

一个优秀的请求封装应该解决三个核心问题:统一配置、拦截器处理、异常监控。

💡 核心逻辑:拦截器(Interceptor)

Uni-app 提供了 uni.addInterceptor,但更灵活的做法是基于 Promise 自己封装一个类。


📝 实战:高扩展性的请求类封装

我们可以创建一个 request.js:

javascript 复制代码
// 基础配置
const BASE_URL = 'https://api.example.com';

export const request = (options) => {
    return new Promise((resolve, reject) => {
        // 1. 请求拦截:注入 Token
        const token = uni.getStorageSync('token');
        const header = {
            'Content-Type': 'application/json',
            ...options.header
        };
        if (token) header['Authorization'] = `Bearer ${token}`;

        uni.request({
            url: BASE_URL + options.url,
            method: options.method || 'GET',
            data: options.data || {},
            header: header,
            timeout: 10000,
            success: (res) => {
                // 2. 响应拦截:统一处理状态码
                const { statusCode, data } = res;
                
                if (statusCode === 200) {
                    if (data.code === 200) {
                        resolve(data.data); // 只返回业务数据
                    } else if (data.code === 401) {
                        // Token 失效,跳转登录
                        uni.navigateTo({ url: '/pages/login/login' });
                        reject(data);
                    } else {
                        uni.showToast({ title: data.msg || '业务错误', icon: 'none' });
                        reject(data);
                    }
                } else {
                    uni.showToast({ title: `网络错误: ${statusCode}`, icon: 'none' });
                    reject(res);
                }
            },
            fail: (err) => {
                uni.showToast({ title: '连接服务器失败', icon: 'none' });
                reject(err);
            }
        });
    });
};

🛠️ 进阶:如何优雅地调用?

不要在页面里直接引用 request.js,建议建立一个 api 模块:

api/user.js

javascript 复制代码
import { request } from './request.js';

export const login = (data) => request({ url: '/auth/login', method: 'POST', data });
export const getUserInfo = () => request({ url: '/user/info' });

pages/index.vue

javascript 复制代码
import { getUserInfo } from '@/api/user.js';

async onLoad() {
    try {
        const info = await getUserInfo();
        this.userInfo = info;
    } catch (e) {
        // 错误已在封装层统一弹窗,这里处理特定逻辑即可
    }
}

⚠️ 避坑指南:小程序端的并发限制

  1. 并发限制 :微信小程序同域名下的并发请求不能超过 10个。如果页面初始化瞬间发出 15 个请求,后 5 个会报错。
  • 对策:合并接口,或者在封装层实现一个"请求队列"。
  1. HTTPS:小程序生产环境必须使用 HTTPS,且要在后台配置域名白名单。
  2. 大文件上传 :上传文件不要用 uni.request,必须使用 uni.uploadFile,它的封装逻辑与普通请求类似,但拦截器处理略有不同。

💡 核心总结

  1. 剥离 BaseURL:方便一键切换开发版、测试版、生产版。
  2. 响应拦截器:是处理"登录失效"最优雅的地方。
  3. Promise 化 :配合 async/await 使用,让异步代码像同步一样整洁。

相关推荐
wuxianda10302 小时前
uniapp 与跨端打包项目:壳子和框架层默认特征,相似是从哪里来的
uni-app
码间留白2 小时前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
wuxianda10303 小时前
苹果 App 上架 4.3(a) 问题解决方案(适用 uniapp、Objective-C、Swift、Flutter 等项目)
uni-app·objective-c·swift
码间留白2 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
anyup2 天前
自带 uni-app x 页面级能力,uView Pro X 8 个开箱即用的工具函数
前端·vue.js·uni-app
码间留白7 天前
六轮真机实验后,我把鸿蒙直播推流的 UI 全逼成了原生——uni-app 适配 HarmonyOS NEXT 完整复盘
uni-app·鸿蒙·harmonyos next·直播推流·arkts/arkui
c2892480843s9 天前
【鸿蒙心迹】网络请求封装实战:RCP 选型、拦截器与弱网预算
移动开发·网络请求·harmonyos·鸿蒙·rcp
wuxianda10309 天前
2026 苹果审核 4.3 (a) 被拒全解析|Guideline 4.3a spam 马甲包拒审原因 + 避坑方案
flutter·uni-app·苹果上架
头发还在的女程序员10 天前
基于 Spring Boot + Vue 3 + uni-app 的灵活用工系统:四端架构与业务流程设计
vue.js·spring boot·uni-app·灵活用工·灵工系统
Dumbness12 天前
订阅消息弹窗必须在用户点击里调:联调实验室里 timing 和 Mock 支付通知踩的坑
javascript·uni-app