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

配置引用怎样避免写死字符串

配置引用怎样避免写死字符串

一张配置表很少独立存在:掉落表会引用道具,商店表会引用商品,技能表会引用特效。真正容易出问题的不是“能不能引用”,而是名称修改后是否仍然稳定、缺失引用能否提前发现,以及重复定义是否会悄悄覆盖。本节给出一套基于稳定 ID 的引用方式。

学习目标

  • 用稳定 ID 代替显示名称和随意字符串建立跨表引用
  • 在导入阶段检查缺失引用、重复主键和非法重复关系
  • 理解名称变更、ID 迁移和运行时索引之间的边界

引用对象要有稳定主键

显示名称是给人看的,引用 ID 是给系统用的,两者职责不同。比如道具名“铁剑”以后可能改成“旧制铁剑”,但 item.iron_sword 可以保持不变。掉落表只保存这个稳定 ID,运行时再通过索引找到完整道具配置。

稳定ID驱动的跨表引用与校验关系

稳定 ID 最好满足三个条件:全局唯一、创建后尽量不改、与显示文案解耦。是否采用纯数字、UUID 或带命名空间的字符串,要根据工具链决定;关键不是格式,而是生命周期稳定。

导入时同时检查主键和外键

只把字符串改成 ID 还不够。如果导入器不校验,item.sword 写错成 item.sowrd 仍会在运行时变成空引用。正确做法是先建立主表索引,再检查每一条从表记录引用的 ID 是否存在。

下面的 Java 17 示例建立道具索引,并验证掉落表中的引用:

java
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;

public class ConfigReferenceDemo {
    record ItemConfig(String itemId, String displayName) {}
    record DropEntry(String monsterId, String itemId) {}

    public static void main(String[] args) {
        List<ItemConfig> items = List.of(
                new ItemConfig("item.iron_sword", "铁剑"),
                new ItemConfig("item.potion_small", "小型治疗药水")
        );

        List<DropEntry> drops = List.of(
                new DropEntry("monster.goblin", "item.iron_sword"),
                new DropEntry("monster.slime", "item.potion_small")
        );

        Map<String, ItemConfig> itemIndex = buildItemIndex(items);
        validateDropReferences(drops, itemIndex);

        System.out.println("validated items=" + itemIndex.size()
                + ", drops=" + drops.size());
    }

    static Map<String, ItemConfig> buildItemIndex(List<ItemConfig> items) {
        Map<String, ItemConfig> index = new LinkedHashMap<>();
        for (ItemConfig item : items) {
            if (index.putIfAbsent(item.itemId(), item) != null) {
                throw new IllegalArgumentException(
                        "duplicate itemId: " + item.itemId());
            }
        }
        return index;
    }

    static void validateDropReferences(
            List<DropEntry> drops,
            Map<String, ItemConfig> itemIndex) {
        for (DropEntry drop : drops) {
            if (!itemIndex.containsKey(drop.itemId())) {
                throw new IllegalArgumentException(
                        "missing item reference: " + drop.itemId());
            }
        }
    }
}

预期输出:

text
validated items=2, drops=2

这个顺序很重要:先确认主键唯一,再验证引用存在。否则重复主键可能在构建索引时被后值覆盖,引用虽然“查得到”,实际绑定到的却不是预期对象。

重复引用不等于重复定义

同一个道具被多个怪物、商店或奖励组引用通常是正常关系,不能因为 itemId 重复出现就判错。真正需要阻止的是主表里出现两个相同主键,或者业务规则明确要求唯一关系时出现重复记录。

例如“一个怪物可掉落多个相同道具但概率不同”是否允许,要由掉落规则决定;如果不允许,可以把 (monsterId, itemId) 作为组合唯一键进行校验。不要把所有重复都简单归为数据错误。

名称能改,ID 迁移要显式处理

显示名称变化只改主表字段即可,从表引用不需要动。如果业务上确实必须更换 ID,不要直接批量替换后上线,而应把它当成一次数据迁移:更新所有引用、重新跑完整性校验,并确认存档、缓存或热更数据里是否还保存旧 ID。

运行时最好把稳定 ID 解析成内存索引或对象引用,业务逻辑不要到处手写字符串比较。这样字符串只存在于配置边界,缺失引用在导入阶段失败,名称调整也不会扩散成代码修改。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置引用怎样避免写死字符串

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

登录哪都通