Puerts项目中QuickJS后端处理JS异常抛出null导致崩溃问题分析

问题背景

在Puerts项目中使用QuickJS作为JavaScript后端时，开发团队发现了一个关键性问题：当JavaScript代码中抛出null值时，会导致整个应用程序崩溃。这个问题在游戏开发中尤其危险，因为游戏需要保持高稳定性，任何崩溃都会直接影响玩家体验。

技术原理

QuickJS是一个轻量级的JavaScript引擎，以其高性能和小体积著称。在正常的JavaScript执行环境中，throw语句可以抛出任何值，包括null和undefined。然而，在QuickJS与Unity的集成环境中，对异常处理的机制需要特殊处理。

在原生JavaScript环境中，抛出null是完全合法的：

throw null; // 这在标准JS中是允许的

但在Puerts的QuickJS后端实现中，当JS代码抛出null时，由于缺乏对这种情况的适当处理，会导致底层C++代码访问空指针，进而引发程序崩溃。

问题影响

这个bug的影响范围包括：

1. 所有使用Puerts+QuickJS后端的Unity项目
2. 任何可能抛出null的JavaScript代码
3. 特别是那些从外部加载的、不受开发者完全控制的JS脚本

在实际游戏开发中，这种情况可能导致：

• 游戏突然崩溃退出
• 开发过程中难以调试的稳定性问题
• 线上游戏不可预知的崩溃

解决方案

开发团队通过两个关键提交修复了这个问题：

1. 空值检查机制：在异常处理路径中添加了对null值的显式检查，确保当JS抛出null时，能够被正确捕获并转换为合适的异常对象，而不是直接导致崩溃。

2. 异常封装处理：完善了JS异常到C++异常的转换机制，确保所有类型的JS异常（包括null）都能被安全地处理，而不会导致未定义行为。

技术实现细节

修复的核心在于修改了QuickJS与Puerts之间的异常桥接层。具体包括：

• 在JS异常捕获时增加类型检查
• 对null和undefined等特殊值进行特殊处理
• 确保异常信息能够正确传递而不丢失
• 保持与标准JavaScript异常处理行为的一致性

最佳实践建议

基于这个问题的经验，建议Puerts开发者：

1. 在JavaScript代码中避免直接抛出原始值（如null或undefined），而是抛出Error对象：

// 不推荐
throw null;

// 推荐
throw new Error("明确的错误信息");

2. 在关键代码路径添加try-catch块，即使你认为不会抛出异常。

3. 定期更新Puerts版本，以获取最新的稳定性修复。

总结

这个问题的修复体现了Puerts团队对稳定性的重视。通过正确处理JavaScript中的所有可能异常情况，Puerts+QuickJS的组合变得更加健壮，能够更好地服务于游戏开发等高要求的应用场景。这也提醒我们，在桥接不同语言环境时，必须特别注意类型系统和异常处理机制的差异。