游戏客户端架构 / 系统课时
网络失败后的 UI 怎么恢复
网络失败后的 UI 怎么恢复
网络异常不应该把界面变成“半加载、半可点”的未知状态。本节把重试、超时、降级和离线提示组织成明确状态机,让请求失败后 UI 能回到可理解、可操作、可再次尝试的状态。
学习目标
- 把网络请求结果映射为可预测的 UI 状态
- 区分重试、降级、超时和离线提示的适用条件
- 避免重复点击、旧响应覆盖和无限重试
先把失败状态设计成有限集合
一个请求型界面至少需要区分 Loading、Content、Empty、Error 和 Offline。如果把失败只处理成一条 Toast,原来的加载骨架、按钮禁用状态和旧数据就可能残留,用户不知道当前页面到底能不能继续用。

状态一旦明确,恢复策略就能稳定下来:首屏失败进入错误页;已有旧数据时刷新失败保留内容,只显示非阻断提示;明确无网络时给离线提示;超时允许用户主动重试。
用状态机而不是零散布尔值
isLoading、hasError、isOffline 三四个布尔值很容易组合出非法状态,例如同时“加载中”和“错误”。用互斥状态表达页面更安全。
下面示例模拟一个请求控制器:第一次请求超时,第二次重试成功。代码使用 .NET 自带类型,不依赖特定游戏引擎。
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);
}
}预期输出
state=Loading
show retry button
state=Error
state=Loading
render player-profile
state=Content关键点不是异常类型本身,而是异常发生后必须明确落到某个 UI 状态。否则加载遮罩、交互锁和错误提示可能各自停留在不同阶段。
重试、超时和降级怎么分工
重试适合瞬时故障,例如短暂丢包、服务端临时不可用。自动重试次数应有限,并配合退避;用户主动点击“重试”则应重新进入 Loading,同时禁止连续点击制造并发请求。
超时负责给“迟迟没有结果”的请求一个结束点。超时后 UI 要解除加载锁,并提供重试或返回路径,而不是无限等待。
降级适合“有旧数据也比完全空白好”的区域,例如排行榜缓存、好友列表快照、活动配置缓存。降级时要明确标注“数据可能不是最新”,避免把旧数据伪装成实时结果。
离线状态不要等到请求报错才解释
如果客户端已经知道设备离线,可以直接进入 Offline,避免先展示长时间 Loading 再报错。网络恢复后也不要强制所有页面同时刷新,优先刷新当前可见页面和高价值 HUD 数据,减少瞬间并发。
对于战斗 HUD,还应考虑“网络数据冻结但本地交互继续”的情况。例如技能按钮可继续显示本地冷却动画,但服务端确认类操作需要禁用或标注等待同步。
防止恢复过程再次破坏状态
最常见的二次问题有两个:用户连续点重试导致并发请求;旧请求比新请求更晚返回,覆盖了新数据。解决方式与资源异步加载类似:重试期间锁住触发入口,并给请求增加序号或取消前一个请求,只接受最新结果。
最终目标不是保证网络永不失败,而是保证每种失败都有确定出口。用户应该始终能看懂当前状态,并知道下一步是等待、重试、继续使用旧数据,还是离线返回。