Excalibur游戏引擎中空场景加载器导致的场景切换问题分析

问题现象

在Excalibur游戏引擎(0.30.0-alpha.1106版本)中，开发者发现当使用一个未添加任何资源的空加载器(Loader)进行场景切换时，引擎会出现无法完成场景切换且后续事件处理被锁定的严重问题。具体表现为：

1. 从Scene1调用this.engine.goToScene("Scene2")时，控制台会输出日志但场景不会实际切换
2. 引擎的事件系统完全停止响应，包括指针移动等所有输入事件
3. 游戏画面停留在原场景，无法继续任何交互

问题复现条件

这个问题在以下环境中可稳定复现：

• 定义了两个场景：Scene1(深灰色背景)和Scene2(绿色背景)
• Scene2配置了独立的加载器实例但没有添加任何资源
• Scene2的onPreLoad方法被重写但没有调用父类方法或添加任何资源
• 在Scene1中通过指针事件触发场景切换

技术原理分析

经过深入分析，这个问题源于Excalibur引擎内部场景切换机制的一个边界条件处理缺陷：

1. 场景切换流程：Excalibur在切换场景时会先执行目标场景的预加载阶段(onPreLoad)，然后通过加载器完成资源加载，最后才实际激活新场景。

2. 空加载器问题：当加载器没有任何资源需要加载时，引擎错误地跳过了整个加载完成流程，导致场景切换状态机停留在中间状态，既没有完成旧场景的卸载，也没有开始新场景的初始化。

3. 事件系统锁定：由于场景切换未完成，引擎可能处于一个不一致的状态，错误地阻止了后续所有事件的派发和处理。

解决方案

目前有两种可行的解决方案：

1. 临时解决方案：在空加载器中添加一个虚拟资源

loader.addResource({
  data: {},
  isLoaded: () => true,
  load: () => Promise.resolve(),
});

2. 根本解决方案：修改引擎代码，正确处理空加载器的情况，确保即使没有资源需要加载也能完成场景切换流程。

最佳实践建议

为了避免类似问题，建议开发者在实现自定义场景时：

1. 如果不需要预加载资源，最好不要重写onPreLoad方法
2. 如果必须重写onPreLoad，确保调用父类方法(super.onPreLoad(loader))
3. 对于确实不需要加载资源的场景，考虑不使用独立的加载器配置
4. 在自定义加载逻辑时，始终确保加载流程能正常完成，即使是空加载情况

影响范围

该问题影响所有使用Excalibur 0.30.0-alpha.1106版本且配置了空加载器的场景切换场景。在macOS系统上的Firefox和Chrome浏览器中已确认存在，其他平台和浏览器也可能受影响。

总结

这个案例展示了游戏引擎中边界条件处理的重要性。Excalibur团队已经意识到这个问题并着手修复，开发者暂时可以通过添加虚拟资源的方式规避。这也提醒我们在使用游戏引擎时，需要充分理解其内部状态机和工作原理，特别是在处理异步操作和资源加载时。