Puerts项目中QuickJS模式关闭时崩溃问题分析与解决方案

问题背景

在Unreal Engine 4.27环境下使用Puerts插件时，开发者发现当启用QuickJS模式并在JsEnv->Start函数中传入UObject对象参数时，程序在关闭时会出现崩溃现象。这一问题在Puerts 1.0.5至1.0.7版本中均有出现，但在V8模式下则表现正常。

问题现象

具体表现为：当通过JsEnv->Start函数传递UObject对象参数到JavaScript环境时，QuickJS模式在JsEnv析构阶段会触发崩溃。如果不传递UObject参数，则不会出现此问题。崩溃发生时通常会伴随内存访问违规的错误提示。

技术分析

经过深入排查，发现问题根源在于QuickJS库版本更新后引入的兼容性问题。具体表现为：

1. 新版本QuickJS在执行log.js时，会报告global.puerts为undefined
2. 问题出在对全局对象设置属性时，JS_SetProperty函数调用失败
3. 改用JS_SetPropertyStr函数则可以成功设置属性
4. QuickJS内部实现中，JS_SetProperty直接调用JS_SetPropertyInternal，而新版本中JS_SetPropertyInternal的参数发生了变化

解决方案

针对这一问题，Puerts团队提供了几种解决方案：

1. 回退QuickJS版本：使用特定版本的QuickJS库（2024年4月24日版本）可以避免此问题

2. 清理编译缓存：彻底清理工程中的Intermediate和Binaries目录，包括Puerts插件自身的中间文件，然后重新生成工程

3. 版本选择建议：

   • 1.0.5版本在回退QuickJS后仍存在问题
   • 1.0.6和1.0.7版本在回退QuickJS后表现正常

最佳实践建议

对于Unreal Engine项目中使用Puerts的开发团队，建议：

1. 合理选择JavaScript引擎：

   • 编辑器环境下优先使用V8引擎
   • HTML5平台再启用QuickJS支持

2. 版本管理：

   • 保持Puerts插件和QuickJS库版本的匹配
   • 注意不同版本间的兼容性差异

3. 环境清理：

   • 在升级或切换版本时，彻底清理编译缓存
   • 包括工程目录和插件目录下的Intermediate和Binaries

总结

QuickJS作为轻量级JavaScript引擎，在特定场景下有其优势，但也需要注意版本兼容性问题。通过合理选择版本、彻底清理编译环境和遵循最佳实践，可以有效避免此类崩溃问题。对于Unreal Engine项目，建议根据目标平台灵活选择JavaScript引擎，以获得最佳开发体验和运行性能。