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 @@