游戏客户端架构 / 系统课时
界面重复创建怎么定位
界面重复创建怎么定位
“点一次按钮却出现两个面板”通常不是单一的创建函数写错,而是重复请求、旧实例未注销或异常恢复再次补建共同造成的。本节给出一套可复用的定位顺序:先证明是否真的有多个实例,再追创建来源和残留引用,最后验证修复后栈、注册表与生命周期是否一致。
学习目标
- 区分重复创建、重复显示和残留实例三类现象
- 用实例 ID、创建来源和生命周期日志定位重复入口
- 建立单实例保护与销毁校验,防止修复后再次回归
先确认到底重复了什么
看到两个相同界面时,先不要直接加“防抖”。重复现象至少有三种来源:真的创建了两个实例;只有一个实例,但重复加入渲染层或动画容器;旧实例已经不可见,却仍留在路由栈、事件总线或全局引用中,下一次恢复时又被重新激活。
最有效的第一步,是给每个 UI 实例分配稳定的运行期 ID,并记录 Create、Show、Hide、Destroy 事件。若日志中出现两个不同 ID 的 Create,才说明是重复实例;若只有一个 ID 却多次 Show,应转查挂载或显示逻辑。

用日志把创建来源钉死
排查时至少记录四个字段:界面类型、实例 ID、动作、调用来源。调用来源不一定要保存完整堆栈,先保存一个业务来源标签就够用,例如 OpenFromHud、RestoreAfterReconnect、RetryCallback。这样可以快速看出两个实例是否来自不同恢复路径。
下面的可运行 C# 示例模拟一个注册表:第一次创建 Inventory 后,第二次请求会复用现有实例,并把关键动作打印出来。
using System;
using System.Collections.Generic;
public sealed class UiRegistry
{
private readonly Dictionary<string, string> _instances = new();
public string Open(string uiName, string source)
{
if (_instances.TryGetValue(uiName, out var existingId))
{
Console.WriteLine($"Reuse {uiName} id={existingId} source={source}");
return existingId;
}
var id = Guid.NewGuid().ToString("N")[..8];
_instances[uiName] = id;
// 记录创建来源,出现重复实例时可直接追到第二个入口。
Console.WriteLine($"Create {uiName} id={id} source={source}");
return id;
}
public void Destroy(string uiName)
{
if (_instances.Remove(uiName, out var id))
{
Console.WriteLine($"Destroy {uiName} id={id}");
}
}
}
public static class Program
{
public static void Main()
{
var registry = new UiRegistry();
registry.Open("Inventory", "OpenFromHud");
registry.Open("Inventory", "RestoreAfterReconnect");
registry.Destroy("Inventory");
}
}预期输出中的实例 ID 是动态值,实际内容会不同:
Create Inventory id=<ID> source=OpenFromHud
Reuse Inventory id=<ID> source=RestoreAfterReconnect
Destroy Inventory id=<ID>如果现网问题已经发生,建议临时把日志扩展为“时间、线程或帧号、路由栈深度、实例 ID、来源”。只要能把两个 Create 对齐到具体来源,排查范围就会从整个 UI 系统缩小到一两个调用链。
按三条链检查残留
创建链要检查“谁调用了创建”。常见问题是按钮点击和网络回调同时触发打开,或者异步加载完成后没有重新确认目标界面是否已经存在。恢复链要检查断线重连、场景切换、热重载、异常捕获后的补建逻辑,它们最容易绕过正常路由入口。
销毁链则看对象虽然离开屏幕,是否仍被某处持有。事件总线未退订、全局字典未删除、UI 栈忘记 Pop、闭包捕获旧实例,都可能让对象继续存活。此时下一次 Open 若只判断“当前是否可见”,就会再创建一个新实例。
修复后用不变量验收
修复不应只看“肉眼不重叠”。对单实例页面,可以明确三个不变量:注册表中同类型最多一个活实例;UI 栈中同一实例最多出现一次;实例进入 Destroyed 后,不再接收事件,也不能被恢复逻辑重新 Show。
回归时至少覆盖正常打开关闭、快速连点、异步加载未完成时重复打开、断线重连、场景切换和异常恢复。若这些路径都经过同一个 OpenOrFocus 或等价入口,重复创建问题通常就从“偶现 UI Bug”变成了可验证的生命周期约束。
最终要修的不是某一次多出来的面板,而是让“创建、注册、入栈、销毁、注销”形成一条闭环;只要其中任一步可以绕过,重复实例就迟早会再次出现。