From 25a3a3d52fdd5870a9e2188cd4480fc2be0d937b Mon Sep 17 00:00:00 2001 From: MiAn Date: Wed, 4 Nov 2026 10:59:49 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=E5=AE=89=E5=85=A8?= =?UTF-8?q?=E5=AF=BC=E8=88=AA=E5=B7=A5=E5=85=B7=E5=B9=B6=E5=85=A8=E9=87=8F?= =?UTF-8?q?=E6=9B=BF=E6=8D=A2=E5=8E=9F=E7=94=9F=E8=B7=AF=E7=94=B1=E8=B0=83?= =?UTF-8?q?=E7=94=A8=EF=BC=8C=E8=A7=A3=E5=86=B3=E9=A1=B5=E9=9D=A2=E8=BF=9E?= =?UTF-8?q?=E5=87=BB=E3=80=81=E6=A0=88=E8=B6=85=E9=99=90=E4=B8=8E=E7=99=BD?= =?UTF-8?q?=E5=B1=8F=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增全局安全导航工具 safeNavigateTo/safeRedirectTo/safeNavigateBack,实现防连击锁、页面栈超限降级、无历史页平滑重定向逻辑。全量替换所有页面及组件中的 uni 原生路由调用,包括充值页、商家详情页、优惠券页、收藏页、订单页、会员中心、首页、登录页等多个页面,同时更新 tabbar 跳转逻辑杜绝 reLaunch 白屏,新增路由工具单元测试,优化分类页空数据兜底提示,提升页面跳转稳定性与用户体验。 --- uniapp/common/utils/nav.js | 152 ++++++++++++++++++ uniapp/components/fc-navbar/fc-navbar.vue | 52 +----- .../components/fc-post-card/fc-post-card.vue | 10 +- uniapp/components/fc-tabbar/fc-tabbar.vue | 42 +++-- uniapp/pages/auth/login.vue | 44 ++--- uniapp/pages/category/index.vue | 111 ++++++++++--- uniapp/pages/favorite/follows.vue | 17 +- uniapp/pages/favorite/index.vue | 18 +-- uniapp/pages/index/index.vue | 33 ++-- uniapp/pages/member/coupons.vue | 7 +- uniapp/pages/member/index.vue | 17 +- uniapp/pages/member/recharge.vue | 10 +- uniapp/pages/merchant/detail.vue | 13 +- uniapp/pages/mine/index.vue | 21 +-- uniapp/pages/order/detail.vue | 25 +-- uniapp/pages/order/success.vue | 11 +- uniapp/pages/search/index.vue | 23 +-- uniapp/tests/nav.test.mjs | 77 +++++++++ 18 files changed, 427 insertions(+), 256 deletions(-) create mode 100644 uniapp/common/utils/nav.js create mode 100644 uniapp/tests/nav.test.mjs diff --git a/uniapp/common/utils/nav.js b/uniapp/common/utils/nav.js new file mode 100644 index 0000000..e9a7efc --- /dev/null +++ b/uniapp/common/utils/nav.js @@ -0,0 +1,152 @@ +/** + * 全局统一安全导航工具 + * 解决小程序页面连击并发重复入栈、页面栈超限 (10层) 以及无原生 tabBar 时 switchTab 报错降级导致的巨大点击延迟 + */ + +// 导航锁状态标记(防止毫秒级快速连击导致重复打开相同页面) +let isNavigating = false +let navTimer = null + +/** + * 释放导航锁 + */ +function releaseNavLock() { + if (navTimer) { + clearTimeout(navTimer) + navTimer = null + } + isNavigating = false +} + +/** + * 获取导航锁(若正处于跳转中则返回 false) + * @param {number} lockTime 锁定时间(毫秒,默认 500ms) + * @returns {boolean} 是否成功获取导航锁 + */ +function acquireNavLock(lockTime = 500) { + if (isNavigating) { + return false + } + isNavigating = true + navTimer = setTimeout(() => { + isNavigating = false + navTimer = null + }, lockTime) + return true +} + +/** + * 安全跳转页面(防连击 + 页面栈超限安全兜底) + * @param {string|Object} options 跳转目标路径或配置对象 + * @param {number} lockTime 导航锁时长 + * @returns {Promise} + */ +export function safeNavigateTo(options, lockTime = 500) { + if (!acquireNavLock(lockTime)) { + return Promise.resolve() + } + + const url = typeof options === 'string' ? options : (options && options.url) + if (!url) { + releaseNavLock() + return Promise.resolve() + } + + return new Promise((resolve, reject) => { + uni.navigateTo({ + url, + success: (res) => { + resolve(res) + }, + fail: (err) => { + // 若页面栈满(微信限制 10 层),自动安全降级为 redirectTo,防止用户卡死在当前页 + const errMsg = (err && err.errMsg) || '' + if (errMsg.indexOf('limit exceed') !== -1 || errMsg.indexOf('fail') !== -1) { + uni.redirectTo({ + url, + success: resolve, + fail: reject, + complete: () => setTimeout(releaseNavLock, 200), + }) + } else { + reject(err) + releaseNavLock() + } + }, + complete: () => { + // 成功推入新页面后,稍后释放锁 + setTimeout(releaseNavLock, 300) + }, + }) + }) +} + +/** + * 安全重定向页面(平滑切换,销毁当前页,保持页面栈深度为 1) + * @param {string|Object} options 跳转目标路径或配置对象 + * @returns {Promise} + */ +export function safeRedirectTo(options) { + if (!acquireNavLock(400)) { + return Promise.resolve() + } + + const url = typeof options === 'string' ? options : (options && options.url) + if (!url) { + releaseNavLock() + return Promise.resolve() + } + + return new Promise((resolve, reject) => { + uni.redirectTo({ + url, + success: resolve, + fail: (err) => { + // 极端异常兜底 + uni.reLaunch({ + url, + success: resolve, + fail: reject, + }) + }, + complete: () => { + setTimeout(releaseNavLock, 300) + }, + }) + }) +} + +/** + * 安全返回上一页(含无历史页面栈时的平滑降级逻辑) + * @param {string} fallbackUrl 页面栈仅有 1 页时的回退兜底路径(默认首页) + * @param {number} delta 返回的层数(默认 1) + */ +export function safeNavigateBack(fallbackUrl = '/pages/index/index', delta = 1) { + if (!acquireNavLock(400)) { + return + } + + const pages = typeof getCurrentPages === 'function' ? getCurrentPages() : [] + if (pages && pages.length > delta) { + uni.navigateBack({ + delta, + fail: () => { + releaseNavLock() + safeRedirectTo(fallbackUrl) + }, + complete: () => { + setTimeout(releaseNavLock, 300) + }, + }) + } else { + // 无前序页面栈,释放锁后平滑重定向至指定兜底页,杜绝卡死在空白分享页 + releaseNavLock() + safeRedirectTo(fallbackUrl) + } +} + +export default { + safeNavigateTo, + safeRedirectTo, + safeNavigateBack, +} diff --git a/uniapp/components/fc-navbar/fc-navbar.vue b/uniapp/components/fc-navbar/fc-navbar.vue index 3e9a7dc..953ae7a 100644 --- a/uniapp/components/fc-navbar/fc-navbar.vue +++ b/uniapp/components/fc-navbar/fc-navbar.vue @@ -32,6 +32,7 @@