uni-app 中 setInterval 在后台会被暂停,无法真正“退出应用保持计时”:应用进入后台时,setInterval/ setTimeout 会被系统挂起或降频,iOS 微信中几秒后即停止;可行方案是存起点时间戳与总秒数,前台时通过 Date.now() 计算剩余时间并续计。

uni-app 中 setInterval 在后台会被暂停,无法真正“退出应用保持计时”
这是最常被误解的一点:uni-app(基于微信小程序、App、H5 多端)中,只要应用进入后台(比如切到微信首页、锁屏、切换 App),setInterval 或 setTimeout 会立即被系统挂起或大幅降频——iOS 微信里甚至几秒后就完全停止。所以「退出应用还继续倒计时」在纯前端层面根本做不到。
真正可行的路径只有一条:把倒计时起点和剩余时间存下来,下次进前台时重新计算并恢复 UI。关键不是“保持计时”,而是“精确续算”。
实操建议:
- 点击获取验证码时,立刻用
uni.setStorageSync记录当前时间戳(startTime)和倒计时总秒数(如60) - 进入页面 onShow 钩子中读取缓存,用
Date.now() - startTime算出已过去秒数,得到剩余时间remain = 60 - elapsed - 如果
remain ,清空缓存、显示“获取验证码”;否则启动setInterval继续倒数(注意每次都要更新 UI,不依赖后台运行) - 务必在用户成功发送/跳转/关闭页面前调用
uni.removeStorageSync清理缓存,避免残留逻辑干扰
倒计时组件必须监听 onHide 和 onShow,不能只靠 mounted
很多开发者只在 mounted 启动倒计时,结果切后台再回来,UI 完全失步(比如显示“58s”,实际已过去 2 分钟)。uni-app 的生命周期比 Vue Web 更关键。
正确做法是把倒计时控制逻辑抽成方法,并在两个地方触发:
-
onShow:必做 —— 检查缓存、计算剩余时间、决定是否启动/重启setInterval -
onHide:建议做 —— 清除当前setInterval实例(避免内存泄漏),但**不要清除缓存**(那是续算依据) - 倒计时结束时,除了重置按钮状态,一定要同步调用
uni.removeStorageSync('smsCountdown')
示例片段(简写):
expire
- 不要用
new Date().getTime(),统一用Date.now()(更轻量,无兼容问题) - 存缓存时用
uni.setStorageSync('smsCountdown', { expire: Date.now() + 60000 }) - 避免在
onLoad存缓存 —— 此时用户还没点“获取验证码”,属于误触发
App 端可配合 plus.runtime.restart() 做兜底,但不解决本质问题
原生 App(uni-app 编译为 iOS/Android)中,plus.runtime.restart() 能强制刷新 JS 上下文,但倒计时仍无法跨进程存活。它唯一有用场景是:检测到缓存中的 expire 已过期,但 UI 还卡在倒计时状态(比如用户杀进程后重进)。此时可主动 restart 刷新整个页面。
但这属于异常兜底,不该作为主流程。真正要做的,还是前面三点:存 expire 时间戳、onShow 续算、严格清理缓存。
容易被忽略的细节:
- H5 端切标签页也会触发
onHide,行为和小程序一致,别单独给 H5 写特殊逻辑 - 微信小程序开发工具里模拟后台可能不准确,真机测试才能验证
onHide/onShow触发时机 - 倒计时按钮禁用状态必须和
countdown > 0严格绑定,不能只靠 CSS 样式掩盖











