游戏客户端架构 / 系统课时

网络失败后的 UI 怎么恢复

网络失败后的 UI 怎么恢复

网络异常不应该把界面变成“半加载、半可点”的未知状态。本节把重试、超时、降级和离线提示组织成明确状态机,让请求失败后 UI 能回到可理解、可操作、可再次尝试的状态。

学习目标

  • 把网络请求结果映射为可预测的 UI 状态
  • 区分重试、降级、超时和离线提示的适用条件
  • 避免重复点击、旧响应覆盖和无限重试

先把失败状态设计成有限集合

一个请求型界面至少需要区分 Loading、Content、Empty、Error 和 Offline。如果把失败只处理成一条 Toast,原来的加载骨架、按钮禁用状态和旧数据就可能残留,用户不知道当前页面到底能不能继续用。

网络异常下的 UI 状态恢复流程

状态一旦明确,恢复策略就能稳定下来:首屏失败进入错误页;已有旧数据时刷新失败保留内容,只显示非阻断提示;明确无网络时给离线提示;超时允许用户主动重试。

用状态机而不是零散布尔值

isLoading、hasError、isOffline 三四个布尔值很容易组合出非法状态,例如同时“加载中”和“错误”。用互斥状态表达页面更安全。

下面示例模拟一个请求控制器:第一次请求超时,第二次重试成功。代码使用 .NET 自带类型,不依赖特定游戏引擎。

csharp
using System;
using System.Threading;
using System.Threading.Tasks;

public enum UiState
{
    Loading,
    Content,
    Error
}

public sealed class ScreenController
{
    private int attempt;

    public async Task LoadAsync(CancellationToken token)
    {
        SetState(UiState.Loading);

        try
        {
            string data = await RequestAsync(token);
            Console.WriteLine($"render {data}");
            SetState(UiState.Content);
        }
        catch (TimeoutException)
        {
            Console.WriteLine("show retry button");
            SetState(UiState.Error);
        }
    }

    private async Task<string> RequestAsync(CancellationToken token)
    {
        await Task.Delay(100, token);
        attempt++;

        if (attempt == 1)
        {
            throw new TimeoutException();
        }

        return "player-profile";
    }

    private static void SetState(UiState state)
    {
        Console.WriteLine($"state={state}");
    }
}

public static class Program
{
    public static async Task Main()
    {
        var controller = new ScreenController();
        using var cts = new CancellationTokenSource();

        await controller.LoadAsync(cts.Token);
        await controller.LoadAsync(cts.Token);
    }
}

预期输出

text
state=Loading
show retry button
state=Error
state=Loading
render player-profile
state=Content

关键点不是异常类型本身,而是异常发生后必须明确落到某个 UI 状态。否则加载遮罩、交互锁和错误提示可能各自停留在不同阶段。

重试、超时和降级怎么分工

重试适合瞬时故障,例如短暂丢包、服务端临时不可用。自动重试次数应有限,并配合退避;用户主动点击“重试”则应重新进入 Loading,同时禁止连续点击制造并发请求。

超时负责给“迟迟没有结果”的请求一个结束点。超时后 UI 要解除加载锁,并提供重试或返回路径,而不是无限等待。

降级适合“有旧数据也比完全空白好”的区域,例如排行榜缓存、好友列表快照、活动配置缓存。降级时要明确标注“数据可能不是最新”,避免把旧数据伪装成实时结果。

离线状态不要等到请求报错才解释

如果客户端已经知道设备离线,可以直接进入 Offline,避免先展示长时间 Loading 再报错。网络恢复后也不要强制所有页面同时刷新,优先刷新当前可见页面和高价值 HUD 数据,减少瞬间并发。

对于战斗 HUD,还应考虑“网络数据冻结但本地交互继续”的情况。例如技能按钮可继续显示本地冷却动画,但服务端确认类操作需要禁用或标注等待同步。

防止恢复过程再次破坏状态

最常见的二次问题有两个:用户连续点重试导致并发请求;旧请求比新请求更晚返回,覆盖了新数据。解决方式与资源异步加载类似:重试期间锁住触发入口,并给请求增加序号或取消前一个请求,只接受最新结果。

最终目标不是保证网络永不失败,而是保证每种失败都有确定出口。用户应该始终能看懂当前状态,并知道下一步是等待、重试、继续使用旧数据,还是离线返回。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

网络失败后的 UI 怎么恢复

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通