游戏客户端架构 / 系统课时
对象引用为什么不能直接保存
对象引用为什么不能直接保存
运行中的对象引用只在当前进程和当前对象生命周期里有效。关闭游戏后,内存地址、实例顺序甚至对象数量都可能改变,因此存档不能依赖引用本身。可靠做法是保存稳定 ID,再在读档阶段通过注册表重新建立对象之间的关系。
学习目标
- 理解运行时对象引用为什么无法跨进程长期保存
- 使用稳定 ID 表达角色、物品等对象之间的关系
- 在读档时按正确顺序恢复对象并重新绑定引用
引用失效的根本原因
程序里的对象引用指向的是当前运行时创建出的某个实例。无论底层实现最终使用指针、句柄还是托管引用,它描述的都是“这一次运行中的对象”,而不是可以永久识别游戏实体的业务身份。
例如,玩家当前装备着一把剑,运行时可以直接保存 player.Weapon 对剑对象的引用。但重新启动游戏后,旧剑对象已经不存在,新创建出的剑即使内容完全相同,也会是一个新的实例。
因此,存档真正需要保存的不是“引用到哪个内存对象”,而是“玩家装备的是哪一个具有稳定身份的物品”。

用稳定 ID 保存关系
稳定 ID 应描述游戏实体的身份,并且在存档有效期内保持不变。例如一件随机生成装备可以拥有 item-8f31,任务 NPC 可以拥有设计期确定的 npc-blacksmith。存档只保存这些 ID,而不是对象本身的引用。
下面用一个独立的 C# 控制台示例模拟保存和恢复“玩家装备武器”的关系:
using System;
using System.Collections.Generic;
public sealed class Item
{
public string Id { get; init; } = "";
public string Name { get; init; } = "";
}
public sealed class Player
{
public string Id { get; init; } = "";
public Item? EquippedItem { get; set; }
}
public sealed class PlayerSaveData
{
public string PlayerId { get; init; } = "";
public string? EquippedItemId { get; init; }
}
public static class Program
{
public static void Main()
{
// 存档只记录稳定身份,不记录运行时对象引用。
var save = new PlayerSaveData
{
PlayerId = "player-001",
EquippedItemId = "item-sword-001"
};
// 读档时创建本次运行的新对象,并建立 ID 注册表。
var sword = new Item { Id = "item-sword-001", Name = "Iron Sword" };
var player = new Player { Id = save.PlayerId };
var items = new Dictionary<string, Item>
{
[sword.Id] = sword
};
if (save.EquippedItemId is not null &&
items.TryGetValue(save.EquippedItemId, out var equippedItem))
{
player.EquippedItem = equippedItem;
}
Console.WriteLine($"Player: {player.Id}");
Console.WriteLine($"Equipped: {player.EquippedItem?.Name ?? "None"}");
}
}预期输出:
Player: player-001
Equipped: Iron Sword这里恢复出来的 sword 与上一次运行中的剑不是同一个实例,但它们共享同一个持久化身份 item-sword-001,所以玩家与装备之间的业务关系仍然可以正确恢复。
读档时先建对象再连关系
存在互相引用或多层引用时,不要读取一条记录就立即解析所有引用。更稳妥的是分成两个阶段:先根据存档创建对象并全部注册到 ID -> Object 映射,再扫描各对象保存的外部 ID,完成关系绑定。
这种方式可以处理玩家引用物品、任务引用 NPC、队伍成员互相引用等情况,也避免目标对象尚未创建时出现“找不到引用”的顺序依赖。
如果一个 ID 在新版本中已经找不到对应对象,读档逻辑还应明确降级策略,例如将装备置空、替换为默认物品或记录兼容性警告,而不是让整个存档加载失败。