/** * 全链路统一请求层 * - 统一拼接 baseURL / 版本号 * - 自动注入 token * - 统一响应结构解包:{ code, message, data } * - 401 自动清理登录态并跳转登录 * * 该文件为纯 ES Module,Node 测试脚本可直接 import(需先注入 globalThis.uni)。 */ import config from '../config/index.js' import storage from './storage.js' // 401 跳转节流标记(毫秒) let lastLoginRedirectAt = 0 /** * 便于测试注入的运行时环境(默认使用全局 uni) * @returns {Object} 运行时环境对象 */ export function getRuntime() { return { request: typeof uni !== 'undefined' && uni.request ? uni.request.bind(uni) : null, showToast: typeof uni !== 'undefined' && uni.showToast ? uni.showToast.bind(uni) : () => {}, navigateTo: typeof uni !== 'undefined' && uni.navigateTo ? uni.navigateTo.bind(uni) : () => {}, showLoading: typeof uni !== 'undefined' && uni.showLoading ? uni.showLoading.bind(uni) : () => {}, hideLoading: typeof uni !== 'undefined' && uni.hideLoading ? uni.hideLoading.bind(uni) : () => {}, } } /** * 拼接完整地址 * @param {string} url 原始相对或绝对路径 * @returns {string} 完整网络请求地址 */ export function buildUrl(url) { if (/^https?:\/\//i.test(url)) return url const path = url.startsWith('/') ? url : `/${url}` return `${config.baseURL}/${config.apiVersion}${path}` } /** * 组装请求头 * 同时注入 Authorization、token、X-Token,确保在任何 Nginx/Apache 代理环境下 token 都能安全穿透到后端 * @param {Object} extra 额外的自定义请求头 * @returns {Object} 组装后的完整 Headers */ export function buildHeaders(extra = {}) { const token = storage.get(config.storageKeys.token, '') const headers = { 'Content-Type': 'application/json;charset=UTF-8', 'X-Client': 'fenleixinxi', ...extra, } if (token) { // 1. 标准 HTTP Bearer Token headers.Authorization = `Bearer ${token}` // 2. 兼容 FastAdmin 原生与 Nginx/Apache 反向代理(部分反向代理会丢弃 Authorization,但保留常规 Header) headers.token = token headers.Token = token headers['X-Token'] = token } return headers } /** * 清理请求参数中 undefined / null / 空串 的无效字段 * 防止在微信小程序等环境下 GET 请求被底层错误序列化为 "key=undefined" * @param {Object} data 原始请求参数 * @returns {Object} 清理后的参数 */ export function cleanParams(data) { if (!data || typeof data !== 'object' || Array.isArray(data)) return data const cleaned = {} for (const key of Object.keys(data)) { const val = data[key] if (val !== undefined && val !== null && val !== '') { cleaned[key] = val } } return cleaned } /** * 底层请求统一封装(返回 Promise) * @param {Object} options 请求配置 { url, method, data, header, silent } * @returns {Promise} 请求结果 */ export function request(options = {}) { const { url, method = 'GET', data = {}, header = {}, silent = false, // 失败是否静默(不弹 toast) } = options const requestData = String(method).toUpperCase() === 'GET' ? cleanParams(data) : data const runtime = getRuntime() const finalUrl = buildUrl(url) const headers = buildHeaders(header) if (!runtime.request) { return Promise.reject(toErr('当前环境不支持网络请求')) } return new Promise((resolve, reject) => { runtime.request({ url: finalUrl, method: method.toUpperCase(), data: requestData, header: headers, timeout: config.timeout, success(res) { // HTTP 层 401 判定 if (res.statusCode === 401) { onUnauthorized(runtime) return reject(toErr('登录已过期,请重新登录', 401)) } if (res.statusCode < 200 || res.statusCode >= 300) { return handleFail( { message: `网络异常(${res.statusCode})`, statusCode: res.statusCode }, { url, method, data, silent, runtime, resolve, reject } ) } let body = res.data || {} // 若真机或网关未自动反序列化 JSON,或响应携带 UTF-8 BOM 字符,做安全容错剥离并反序列化 if (typeof body === 'string') { try { const cleaned = body.replace(/^\uFEFF/, '').trim() body = JSON.parse(cleaned) } catch (e) { // 保留原 body } } // 业务层 401 判定 if (body.code === 401) { onUnauthorized(runtime) return reject(toErr(body.message || body.msg || '登录已过期,请重新登录', 401)) } // 业务层:约定 code===0 或 code===200 为成功 if (body.code === 0 || body.code === 200) { resolve(body.data !== undefined ? body.data : body) } else { const err = toErr(body.message || body.msg || '请求失败', body.code) if (!silent) runtime.showToast({ title: err.message, icon: 'none' }) reject(err) } }, fail(err) { handleFail(err, { url, method, data, silent, runtime, resolve, reject }) }, }) }) } /** * 失败处理:抛出异常(必要时弹 toast 提示) * @param {Object} err 错误对象 * @param {Object} ctx 请求上下文 */ function handleFail(err, ctx) { const { silent, runtime, reject } = ctx const e = toErr(err && (err.errMsg || err.message) ? err.errMsg || err.message : '网络请求失败') if (!silent) runtime.showToast({ title: e.message, icon: 'none' }) reject(e) } /** * 401 未登录/登录失效统一处理 * 1. 清除本地缓存的 token 与用户信息 * 2. 3秒内节流防抖,避免并发请求时多次重复弹窗与重复跳转 * 3. 避免当前已经在登录页时重复跳转 * 4. 记录来源页面便于登录后无感跳回 * @param {Object} runtime 运行时对象 */ function onUnauthorized(runtime) { storage.remove(config.storageKeys.token) storage.remove(config.storageKeys.userInfo) const now = Date.now() if (now - lastLoginRedirectAt < 3000) { return } lastLoginRedirectAt = now const pages = (typeof getCurrentPages === 'function' && getCurrentPages()) || [] const current = pages[pages.length - 1] const rawRoute = current && (current.route || (current.$page && current.$page.route)) const route = typeof rawRoute === 'string' ? rawRoute : '' if (!route || !route.includes('pages/auth/login')) { runtime.showToast({ title: '登录已过期', icon: 'none' }) const redirectParam = route ? `?redirect=${encodeURIComponent('/' + route)}` : '' runtime.navigateTo({ url: `/pages/auth/login${redirectParam}` }) } } /** * 创建标准化 Error 对象 * @param {string} message 错误消息 * @param {number} code 业务或状态码 * @returns {Error} */ function toErr(message, code = -1) { const e = new Error(message) e.code = code return e } /** 语法糖 */ export const get = (url, data, opts = {}) => request({ url, method: 'GET', data, ...opts }) export const post = (url, data, opts = {}) => request({ url, method: 'POST', data, ...opts }) export const put = (url, data, opts = {}) => request({ url, method: 'PUT', data, ...opts }) export const del = (url, data, opts = {}) => request({ url, method: 'DELETE', data, ...opts }) export default request