乘客切换站点或者退出公交到站页面里有一个看似不起眼的约束:已经离开的页面仍接收到旧站点响应,新的站点列表被覆盖,HTTP 请求对象没有释放导致资源积压。如果直接给事件回调增加更多条件,短期可能看起来好用,却会让下一次需求变更更加困难。

技术主题封面

业务行为与实现目标

页面离开后旧请求回来的问题,是许多网络 UI 的经典竞态。用户刚从站点 A 切到站点 B,B 的响应先返回;几秒后 A 才回来,若处理函数不辨来源,列表会又跳回 A 的旧数据。

“取消展示资格与关闭网络资源是两个不同动作,都必须在页面生命周期和请求结束路径覆盖”是这篇最重要的设计判断。单看成功路径,乘客切换站点或者退出公交到站页面可以靠若干事件回调工作;但只要用户中途修改、取消或重复操作,若没有清晰约束,就无法确定最终输出究竟属于哪一次输入。工程拆分必须以这些不确定性为起点。

我们希望得到的不是一张孤立的效果图,而是一条可追溯的处理链。整个过程拆为创建请求、记录序号、响应回调、判断有效、destroy 资源。每一段只承诺自己负责的结果,下一段不靠猜测前一步的内部状态。对资源清理而言,这种清晰分工也是回归测试能够写得具体的前提。

请求序号可以限制“谁有资格写页面状态”。每次开始新的站点查询就递增 ticket,响应完成时比较自己持有的序号与当前值;页面关闭时再次递增,保证所有旧回调都自然失效。

把决策拆进最小单元

实施选择是:用当前请求序号守护状态提交,在 finally 块销毁 HTTP request;页面离开时递增序号使旧响应失效。这里不能倒过来,先把组件和请求写完,再向现有代码里硬塞判断。规则入口只接收必要数据,输出也尽量可序列化。这样在没有设备的环境下仍能对核心逻辑做确定性检查。

把“创建请求”到“记录序号”视作可中断的边界。任何阶段都可能遇到无效输入或设备状态变化,恢复时应回到上一个仍然可信的事实,而不是为了显示流畅强行跳到最终步骤。这样的路径更适合实际调试。

把“记录序号”和“响应回调”分成两个阶段,是为了让每个阶段都有可检查的输入与输出。乘客切换站点或者退出公交到站页面并不需要复杂框架才能做到这一点,真正需要的是一个稳定的数据契约:前一步产出的值能被下一步清楚识别,失败时也能停在正确的位置。

从“响应回调”走到“判断有效”时,不要直接复用页面当前显示的全部状态。界面可能正在更新,用户也可能继续操作。此处应只传递本阶段约定的数据,并记录这份数据属于哪次动作,减少跨阶段读到不同版本的风险。

这并不等价于真正取消了底层请求。即便页面选择忽略回包,HttpRequest 对象也仍需在成功和失败路径中 destroy。最简单的做法是 try/finally 统一关闭,避免异常绕过清理。

资源清理的关键设计

逐行理解核心代码

下面给出可以独立检查的关键实现。代码只覆盖本篇要证明的核心行为;涉及工程权限、服务端协议或构建设置的条件已在上下文列明。它应被放入明确的模块中,而不是把所有业务逻辑堆进 ArkUI build()。

import { http } from '@kit.NetworkKit'
class StationLoader {
  private ticket: number = 0
  invalidate(): void { this.ticket += 1 }
  async load(url: string): Promise<string | null> {
    const myTicket = ++this.ticket
    const req = http.createHttp()
    try {
      const response = await req.request(url, {
        method: http.RequestMethod.GET,
        readTimeout: 10000
      })
      if (myTicket !== this.ticket) return null
      if (response.responseCode !== 200) return null
      return String(response.result)
    } finally {
      req.destroy()
    }
  }
}

在界面生命周期中应明确哪些动作会使请求失效:切换站点、返回上一页、主动停止刷新、会话退出。不能仅依赖 aboutToDisappear 处理全部业务操作,因为同一页面内切站点也会发生覆盖问题。

代码中的关键判断来自业务约束,而不是某个屏幕比例。以“响应回调”为界,输入应先满足所属阶段的前置条件;当判断失败时,返回错误或保留状态比直接抛出无法解释的页面状态更可控。对需要 UI 反馈的部分,随后由组件转换为明确的文案。

如果把上述核心逻辑接到一个 ArkUI 页面,推荐组件仅处理状态投影和交互事件:例如 TextInput.onChange 接收新的字符串,Button.onClick 触发一次显式动作,得到结果后再设置 @State 驱动展示。对于不是输入框的资源清理功能,则采用相同的单向数据边界而不强行引入 TextInput。

资源清理的运行界面或工程路径

问题分支和异常路径

最应该提前考虑的风险是:不能假设界面组件销毁会自动回收全部底层网络句柄,也不能把主动忽略响应误当服务器端取消。这句话不是发布时随手附加的注意事项,而是编码时必须坚持的限制。只要异常路径缺乏明确处理,下一次回归就可能把一个本来可恢复的状态变成难以判断的失败。

测试采用可控的 A/B 回包顺序,保证 B 先返回 A 后返回,最后只展示 B。再构造请求抛异常和页面关闭,检查每个已创建对象都进入销毁流程;不能凭预览环境没有崩溃就推断没有资源泄漏。

逆序验收。 把正常操作反过来执行,例如先触发响应回调,再补齐记录序号所需要的条件。若界面没有把错误留在错误位置,或者隐式使用上一轮结果,就说明阶段约束并未完全落实。真正的测试应覆盖操作顺序变化,而非只按产品示例步骤点击。

重复验收。 连续两次执行响应回调,再执行判断有效,检查第二次动作是新意图还是前次动作的继续。对于资源清理尤其要明确重复处理规则;“按钮点了两次”是用户行为事实,并不自动意味着应当产生两份业务副作用。

错误恢复。 在判断有效成功、destroy 资源尚未完成的位置构造异常。应能说明数据暂存在哪里,用户看到何种反馈,是否允许重新触发,以及什么条件下必须停止。不要为了追求一张好看的页面而隐藏正在等待确认的真实状态。

跨版本核对。 在数据和配置持续演进的前提下,固定一份输入,记录预期输出;随后修改不相关的界面颜色或布局,再运行同一用例。如果结果变化,说明资源清理与展示层之间出现了不应存在的隐性耦合。

围绕行为做回归

到此四篇串起了完整网络治理链:错误归一避免误导、幂等确保写操作不重放、退避尊重服务端限流、退出清理避免旧结果污染。四者各解决不同的层面,不应混为一个巨型重试函数。

本篇可用以下结果作为验收目标:站点 A→站点 B→返回三步中只显示 B 的结果,所有已创建 request 均进入关闭路径。检验时先从固定输入入手,再加入中途切换、重复操作和失败恢复。可解释的错误结果也属于正确实现的一部分;没有必要为了让每个步骤都显示绿色而悄悄跳过不满足的前置条件。

调试不应从增加大量打印开始。先把创建请求 → 记录序号 → 响应回调 → 判断有效 → destroy 资源按顺序列出来,每次只在边界处记录不含个人信息的阶段与结果类别。这样即使没有真机性能指标,仍能通过构造输入与检查返回值定位哪一步发生分歧;反过来,如果只看最终页面颜色,就难以证明中间没有错误。

关于不能假设界面组件销毁会自动回收全部底层网络句柄,也不能把主动忽略响应误当服务器端取消这一风险,建议把它写进实际测试用例的名称和断言,而不是只放在代码注释。注释会随着重构失效,测试中的输入与预期结果更容易暴露行为变化。测试本身同样要避免依赖随时变化的网络与时间,否则会把产品故障和测试环境偶然因素混在一起。

当方案需要扩展,优先问“新需求将改变哪个阶段”。如果它只改变响应回调,便不应触及后面的判断有效;如果它改变最终业务语义,规则层和序列化层才需要一起调整。这个决策方式能够避免每加一个按钮就复制一份流程逻辑,也使连载中的代码可以逐篇成长。

对于业务异常,提示文案至少要回答当前状态、可以继续的动作以及不能继续的原因。乘客切换站点或者退出公交到站页面里的用户通常不关心内部类名或错误码,但需要知道是等待、重试还是修改输入。把工程错误类别映射为用户可理解的行为建议,比把原始异常堆栈放在对话框里更合适。

交付的验证证据应当与主张相称。纯函数逻辑可以使用固定输入输出来证明;界面效果只能由真实运行或明确标注的示意展示;网络限流、签名、权限等涉及外部系统的结论,需要在对应环境中完成复核。不要把静态检查结果提升为已经完成真实设备测试的结论。

资源清理的扩展场景与异常路径

这类问题的适用边界同样清楚:取消展示资格与关闭网络资源是两个不同动作,都必须在页面生命周期和请求结束路径覆盖。当具体 SDK、设备能力或服务端协议发生变化,应重新查看对应的官方接口约束,再重新跑上述场景验证,而不是根据一张示例图推断系统行为。

官方资料

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐