【跨平台】票务接口治理-02/05:uni-app 登录态接力:Token 过期后避免重复跳转【共创稿事节】
三个页面同时请求活动信息时,服务端刚好让令牌过期。若三个请求分别弹登录页,用户会看到连续跳转;如果三个请求一起刷新,后端又可能拒绝多次提交。
看似简单的功能最容易掩盖边界条件,直到用户快速操作、离线使用或者升级版本时才暴露。 我们围绕“城市场馆预约”的“账户通行证”收紧范围:既要写清实际功能的输入与状态,也要让代码能够被移入 uni-app Vue3 + TypeScript 工程中逐步验证。本文不把普通 uni-app 与 uni-app x 的运行机制混同;平台专用能力会在使用位置说明约束。

从重复异常开始查起
登录态不是一个字符串,而是读取、附带、失效和清理四种行为的集合。401 只代表服务拒绝此次调用,不意味着可以不经确认地抹掉本地草稿,也不意味着刷新接口一定存在。
如果只把“账户通行证”当作一个可见页面,开发时很容易忽略操作背后的状态流。实际应用有用户重复点击、进程被回收、页面重新进入、系统权限被拒绝等情况;这些变化并不会自动遵守 Vue 组件的生命周期。建议先把 uni.request 的调用条件写成可阅读的规则,再决定在哪个页面事件里触发。
对“城市场馆预约”而言,页面组件需要能够回答三个问题:当前展示的数据是否已确认、用户现在还能执行什么动作、失败后哪些数据应继续保留。若这三个问题的答案依赖一个模糊的布尔值,后续出现空态、加载态和待确认态时就会不断补丁式增加判断。
从工程划分来看,services/auth.ts 是本篇关键实现位置。页面与公共服务不应互相猜测对方的数据形状:应明确参数类型、正常返回和需要处理的失败分类;读取与写入的规则在代码审查时分别核对。在票务链路中,读取活动和创建预约虽然共用网络能力,却必须采用不同的重试规则。只读查询可以按策略重试,影响库存的写入则必须具备服务端幂等保证。将二者混成“请求失败自动发一次”,在弱网里反而更危险。
问题不在一个按钮
令牌存在独立 auth repository;请求层读取 token,不在 Vue 页面中硬编码。后端若支持 refreshToken,使用单飞 Promise 限制同一时刻只刷新一次;本篇示例先实现不支持刷新令牌时的统一失效处理,并为后续扩展预留位置。
登录过期后的用户体验需要明确边界:如果用户正在填写预约信息,跳转登录前要保护尚未提交的页面草稿,但不能依赖把整张表单直接放在 URL 查询字符串。服务端可以用 401 表示认证过期,用 403 表示当前身份无权限。前端应根据稳定状态做判断,而不是匹配中文提示字符串。是否设计 refresh token 取决于后台接口;本文特意没有假定后端存在刷新地址,所以先实现不重复跳转,再讨论单飞刷新结构。
落地时先声明最小业务模型,再决定它的持有者。由页面驱动的暂态数据可以用 ref 或 computed;需要在刷新后恢复的结果必须明确读写入口;属于服务端最终决定的字段则不能因为按钮点击而直接写成成功。对“账户通行证”的每一种可见状态,都建议找到对应的数据依据。
修复路径及关键代码
下面保留了与“账户通行证”直接相关的核心实现。示例以标准 uni-app Vue3 工程为目标,服务端地址、业务表结构和平台授权按照项目实际环境配置。连载文章与前文按相同文件职责衔接:前面建立的类型与仓库不在后篇随意改名;独立文章则可以单独复制相应页面或服务进行验证。
// services/auth.ts
const TOKEN_KEY = 'ticket.accessToken';
let isOpeningLogin = false;
export const auth = {
token(): string { return String(uni.getStorageSync(TOKEN_KEY) || ''); },
save(token: string) { uni.setStorageSync(TOKEN_KEY, token); },
clear() { uni.removeStorageSync(TOKEN_KEY); }
};
export function promptLoginOnce(): void {
if (isOpeningLogin) return;
isOpeningLogin = true;
uni.navigateTo({
url: '/pages/account/login',
fail: () => { isOpeningLogin = false; }
});
}
// 登录页完成返回后应显式调用,避免永久锁死导航
export function releaseLoginNavigation() { isOpeningLogin = false; }
export function authorizedGet<T>(url: string): Promise<T> {
return new Promise((resolve, reject) => {
uni.request({
url, method: 'GET', timeout: 12000,
header: auth.token() ? { Authorization: `Bearer ${auth.token()}` } : {},
success: res => {
if (res.statusCode === 401) {
auth.clear(); promptLoginOnce(); reject(new Error('AUTH_REQUIRED'));
} else if (res.statusCode >= 200 && res.statusCode < 300) {
resolve(res.data as T);
} else { reject(new Error(`HTTP_${res.statusCode}`)); }
},
fail: () => reject(new Error('NETWORK'))
});
});
}
从源码阅读顺序看,先定位 services/auth.ts 中的输入,再找到 uni.request 相关调用,最后确认界面状态或存储写回点。这里刻意不把所有规则塞进一个通用帮助函数。跨端适配、数据校验与业务决定属于不同层级;只有约定好每一层的输入和输出,未来更换 UI 或接入新平台时才不会连带修改底层逻辑。
阅读这段实现时,可以沿着“用户动作→页面状态→领域函数→平台 API→结果回写”的方向跟踪。任意一个阶段发生异常,都应知道是保留已有状态、允许重试还是明确阻止下一步,而不是让异常继续冒泡成空白页面。 这正是把逻辑拆成可测试片段的原因:当业务规则改变时,可以只替换数据整形或平台适配逻辑,而不用让每个点击处理函数再次复制错误分支。

多端现场要分开看
H5 Cookie 与小程序 Cookie 行为存在差异,统一采用明确的 Authorization 头是业务方案而不是框架强制要求。令牌存本地缓存并非高安全凭据保险箱,涉及敏感会话应结合服务端失效、短周期和平台安全能力设计。
Web / H5:浏览器 Cookie 并不是跨平台统一身份策略。H5 发送 Authorization 头仍要处理服务端 CORS 对请求头的许可。 在“账户通行证”的部署检查里,必须使用正式目标域名和真实构建产物再走一次主操作;调试服务器的放宽策略、浏览器缓存和桌面设备输入方式都可能掩盖差异。
微信小程序:小程序不应假设接口自动保持浏览器式 Cookie,令牌失效后由业务层统一跳转而不是在每张卡片里导航。 需要将开发者工具调试结果和用户手机上的表现分开保存,重点核对对应权限、域名、生命周期及页面栈规则,避免在调试工具开启“不校验”后宣布兼容。
App:App 首次启动后若系统授权联网较慢,应把网络失败与认证失败分开处理,不能因为连接失败就清空 token。 iOS 与 Android 还应独立执行安装和重进页面流程;涉及鸿蒙 Next 时需遵循 uni-app Vue3 的鸿蒙开发专题与目标 HBuilderX 版本,不能直接假设传统 plus 模块在鸿蒙上可用。
三端一致的部分应尽量体现在数据契约与业务语义中,三端不同的部分则应被清楚标识。比如“账户通行证”对用户呈现的保存、取消、重试这些动作应同义,但它们内部调用的权限检查、资源路径或系统接口可以不同。只有这样,平台迁移才不会变成整页复制。

复盘后的回归用例
多入口登录导航、读取陈旧 token、403 被误判成 401,都会带来“账号刚登录又退出”的表象。调试时需要分离 HTTP 状态、业务 code 和 UI 导航事件,不应直接把完整 token 打进 console。
针对“城市场馆预约”,排查时不要把所有可见异常归入同一个“操作失败”。先问失败发生在输入校验、页面状态转换、平台 API 调用、后台返回还是存储恢复;这五个位置至少要能在日志或可见状态中区分。对用户而言,保留已填写内容通常比重复弹窗更重要;对开发者而言,保留最小触发路径比截取一张成功页更有价值。
建议采用有限的日志字段:模块、动作、错误类别、必要的状态编号和构建版本。对于 uni.request 所涉及的调用,敏感值、文件内容及完整用户资料不应输出。将错误按是否可重试划分之后,页面才能选择展示“重试”“继续编辑”或“前往授权”,而不是遇到任何问题都自动再执行一次。

回归时建议按下面五项逐条操作,不依赖“看起来正常”的主观判断:
1)将有效令牌替换成失效令牌,多个接口仅触发一次登录引导。 先对照本文定义的数据契约确认结果是否可解释,再检查不同运行容器是否走了相同的业务路径。出现差异时应保存最小输入和相应的代码版本,避免凭印象改动多个模块。 对“账户通行证”来说,只有这一项前后的业务记录与页面反馈能够对应,才能把结果记为通过。
2)业务 403 权限不足时不清理登录态。 验收的目标不是证明代码没有任何风险,而是把最容易造成用户损失的边界提前显露。记录触发动作、预期状态、实际状态与修复位置,并在下一次构建时用同一用例回归。 对“账户通行证”来说,只有这一项前后的业务记录与页面反馈能够对应,才能把结果记为通过。
3)退出后清除缓存,再次调用应走未登录状态。 复现时要保留输入条件与触发顺序,先判断页面是否给出确定状态,再核对存储或后台是否真正变化。尤其注意不要把一次偶然成功当作稳定结论;重复执行并检查边界值,能发现只在第二次出现的状态残留。 对“账户通行证”来说,只有这一项前后的业务记录与页面反馈能够对应,才能把结果记为通过。
4)并发请求失败时不输出完整 token 与用户资料。 把该项拆成操作、预期和失败证据三部分:操作必须能由另一个开发者重做;预期尽量描述可见的 UI 或稳定字段;失败证据只记录必要的错误分类和接口状态,不携带隐私信息。 对“账户通行证”来说,只有这一项前后的业务记录与页面反馈能够对应,才能把结果记为通过。
5)在 H5 与微信小程序分别验证登录页返回路径。 不要只测正常网络和一台设备。若涉及异步步骤,至少安排一次连续快速触发以及一次人为中断;若涉及本地数据,则重新打开页面确认恢复结果。这样比盯着开发者工具里的成功提示可靠。 对“账户通行证”来说,只有这一项前后的业务记录与页面反馈能够对应,才能把结果记为通过。
不要让 request 拦截逻辑直接依赖页面栈数量。集中式登录引导负责一次性跳转,具体页面记录未完成的业务意图,用户回到应用后再自行决定是否重新执行。
如果本次只维护一条流程,优先把数据契约、失败状态和用户可执行的下一步做扎实。新增功能前再审视公共服务与平台分支是否仍然清晰;对于需要真实联网、后端配置或设备权限的步骤,应在目标环境执行相应测试,不宜直接把源码静态检查描述成实际编译或真机验证。
收尾与适用范围
这篇围绕“账户通行证”建立了一条从数据边界、调用实现到多端验收的路径。它并不依赖于某种固定配色或 UI 库,重要的是业务动作在正常、取消、中断和重新进入时保持可解释。真正的跨端收益来自共享契约与可维护的端差异,而不是把所有平台都伪装成同一个运行环境。
票务接口治理系列下一篇将沿着同一服务层继续扩展,不另造一套请求协议,重点处理本篇尚未覆盖的交叉状态与恢复路径。
本文所用平台 API 与工程约束可对照 uni-app 官方参考、Vue3 组合式 API 以及 条件编译文档。若使用新版 HBuilderX 或开发 HarmonyOS Next 应以目标版本的文档与设备支持表为准。
更多推荐

所有评论(0)