游戏客户端架构 / 系统课时
处理组件缺失与可选依赖
处理组件缺失与可选依赖
角色生成时可能尚未加载音效,攻击目标也可能在执行前消失。若所有依赖都直接解引用,一个缺失对象就可能使整套角色逻辑报错。本课把依赖分成必需、可选和运行期动态三类,并通过装配入口与执行检查控制各自的失败范围。
学习目标
- 按缺失后果区分必需依赖、可选能力和动态目标。
- 在装配阶段阻止无效组件进入运行态,同时保留无关能力。
- 验证可选能力缺席和目标离场时,业务执行仍符合预期。
先确定三类依赖的失败语义
必需依赖决定一个组件能否正确工作。例如攻击必须知道伤害计算规则 DamageRule;缺少它时应拒绝装配 Attack,而不是把错误拖到首次攻击。是否连角色一起拒绝创建,取决于该角色能否合法地没有攻击能力。
可选依赖只影响附加体验。命中反馈 HitFeedback 缺失时可以不播放音效,但已命中的伤害仍应结算。如果某项反馈是玩法判定的必要条件,就不能将其标成可选依赖。
运行期动态依赖随时间出现或消失,例如锁定目标。攻击组件保留一个稳定的 TargetSlot,每次执行读取其中的当前目标;目标退场时由拥有者清空槽位,而不是让攻击组件长期缓存旧敌人实例。

把失败判断放在装配入口
对象装配层负责检查必需依赖,并决定是否把组件挂到宿主上。示例中的 assemble_attack 缺少规则时返回 None 并报告原因,上层可以只禁用攻击,保留移动、生命值等组件;对于必须战斗的敌人,则应把同一错误升级为生成失败。
组件进入运行态后,不应每帧通过全局服务定位器反复查找规则。可选反馈通过空值分支处理,动态目标则在真正执行攻击时读取;这把装配错误与正常的运行期目标缺席区分开了。
用可运行示例覆盖缺失路径
以下示例使用 Python 3.10 或更高版本。伤害规则是必需依赖,命中反馈是可选依赖;TargetSlot.current 由外部在目标出现或离场时更新,攻击每次读取最新值。
from dataclasses import dataclass
from typing import Protocol
class DamageRule(Protocol):
def calculate(self, base: int) -> int: ...
class DamageTarget(Protocol):
def take_damage(self, amount: int) -> None: ...
class HitFeedback(Protocol):
def on_hit(self) -> None: ...
class FixedRule:
def calculate(self, base: int) -> int:
return base
@dataclass
class TargetSlot:
current: DamageTarget | None = None
@dataclass
class Enemy:
hp: int = 30
def take_damage(self, amount: int) -> None:
self.hp = max(0, self.hp - amount)
print(f'敌人 HP={self.hp}')
class ConsoleHit:
def on_hit(self) -> None:
print('播放命中音效')
class Attack:
def __init__(self, rule: DamageRule, slot: TargetSlot,
feedback: HitFeedback | None = None) -> None:
self._rule = rule
self._slot = slot
self._feedback = feedback
def execute(self) -> None:
# 每次攻击重新读取动态目标,避免缓存过期引用
target = self._slot.current
if target is None:
print('无目标:跳过攻击')
return
target.take_damage(self._rule.calculate(10))
if self._feedback is not None:
self._feedback.on_hit()
def assemble_attack(rule: DamageRule | None, slot: TargetSlot,
feedback: HitFeedback | None = None) -> Attack | None:
# 必需能力缺失时,仅拒绝装配攻击组件
if rule is None:
print('装配失败:攻击缺少 DamageRule')
return None
return Attack(rule, slot, feedback)
slot = TargetSlot()
attack = assemble_attack(FixedRule(), slot)
assert attack is not None
attack.execute()
slot.current = Enemy()
attack.execute()
slot.current = None
attack.execute()
with_audio = assemble_attack(FixedRule(), slot, ConsoleHit())
assert with_audio is not None
slot.current = Enemy()
with_audio.execute()
missing = assemble_attack(None, slot)
print(f'攻击组件已跳过:{missing is None}')预期输出:
无目标:跳过攻击
敌人 HP=20
无目标:跳过攻击
敌人 HP=20
播放命中音效
装配失败:攻击缺少 DamageRule
攻击组件已跳过:True两次成功命中均扣除 10 点生命值;第一种没有音效也不影响伤害。目标为空时不会调用任何受击接口,必需规则缺失时则根本不会创建攻击组件。
处理目标失效与恢复
None 检查只解决槽位为空的问题,并不自动证明对象仍然存活。真正的目标销毁流程应先撤销注册或清空槽位;若使用实体 ID、对象池或跨线程消息,还须校验实体代次和有效性,避免复用对象或迟到事件被误认为旧目标仍在。
需要回归的场景包括无规则、无反馈、无目标、目标退出后重新出现,以及正常命中。对缺失的必需依赖提供可定位的报错,不要用捕获所有异常并继续执行来掩盖真实缺陷。组件失效的处理范围应与业务责任一致,而不是默认摧毁整个游戏对象。