游戏 AI / 系统课时
怎么测试每个阶段边界
怎么测试每个阶段边界
Boss 阶段问题最难测的通常不是阶段内部逻辑,而是刚好跨过阈值的瞬间:血量从 31% 变成 30%、计时从 89.9 秒变成 90 秒,或某个事件恰好在转阶段前后到达。本篇建立可控的测试场景,让入口、出口、重复触发和异常分支都能快速重现。
学习目标
- 用可控输入快速构造阶段边界场景
- 覆盖入口、出口、事件触发和异常分支
- 用断言验证阶段切换后的状态是否完整清理和初始化
先把边界输入变成测试参数
不要直接在真实战斗中等待 Boss 自然降血或计时到点。测试场景应该允许直接设置 healthRatio、elapsedSeconds 和事件输入,并明确当前阶段。这样同一个测试就能把“阈值前”“刚好阈值”“跨过阈值”放在一起比较。

测试边界时尤其要注意两类错误。第一类是比较符号错误,例如业务要求“低于或等于 30% 进入第二阶段”,实现却写成严格小于。第二类是抖动,例如阈值附近反复进入和退出同一阶段,说明进入条件和退出条件没有形成稳定的边界策略。
写一个可重复的边界测试
下面示例使用 Python 标准库 unittest,通过最小状态机演示三个关键边界:31% 不切换、30% 切换、29% 保持第二阶段。把真实 Boss 状态机替换进去时,保留同样的测试结构即可。
import unittest
class BossPhase:
def __init__(self):
self.phase = "phase_1"
def update(self, health_ratio):
# 业务规则:达到 30% 或更低时进入第二阶段。
if self.phase == "phase_1" and health_ratio <= 0.30:
self.phase = "phase_2"
class BossPhaseBoundaryTest(unittest.TestCase):
def test_health_boundary(self):
boss = BossPhase()
boss.update(0.31)
self.assertEqual(boss.phase, "phase_1")
boss.update(0.30)
self.assertEqual(boss.phase, "phase_2")
boss.update(0.29)
self.assertEqual(boss.phase, "phase_2")
if __name__ == "__main__":
unittest.main()预期输出:
.
----------------------------------------------------------------------
Ran 1 test in <TIME>s
OK其中 <TIME> 代表实际运行耗时,可能与示例不同。这个测试验证了最重要的边界语义:阈值前不切换、命中阈值立即切换、切换后不会因为继续低于阈值再次重复进入。
把时间和事件边界一起覆盖
血量只是最常见的入口。对于时间阶段,应至少测试阈值前一个采样点、阈值时刻和阈值后一个采样点;对于事件阶段,则测试首次事件、重复事件和无效事件。测试结果不仅要检查目标阶段,还应检查 currentAction、phaseTimer、阶段专属标记和一次性事件消费状态。
例如,shield_broken 触发特殊阶段后,如果事件没有被消费,下一帧可能再次触发同一转场。测试就应该在第一次处理后再次提交相同 eventId,并断言阶段不重复初始化。
验证异常分支而不是只测成功路径
真正容易在上线后暴露的问题通常来自非法状态输入,例如当前已经是 enraged 却再次收到 phase_2 转换请求,或者 Boss 已死亡时收到新的阶段事件。测试应明确规定这些输入是“忽略”“拒绝”还是“记录错误”,而不是依赖运行时偶然行为。
可以把每个阶段边界整理成一组最小断言:入口条件是否命中、目标阶段是否正确、旧阶段状态是否清理、新阶段状态是否初始化、重复事件是否幂等、非法转场是否被阻止。这样阶段测试就从单点验证变成了完整状态契约。
当测试可以直接注入血量、时间和事件,并覆盖边界前后值、重复事件和非法转场时,Boss 阶段逻辑就获得了一个可快速回归的安全网。后续调整阈值或新增阶段时,只需扩充同一套边界场景,而不必依赖完整战斗流程手工验证。