GraalJS模块模式下Java异常信息丢失问题分析与解决方案

问题背景

在GraalVM 24.2.0版本中，当使用JavaScript模块（.mjs扩展名或application/javascript+module MIME类型）调用Java方法时，如果Java方法抛出异常，原始的Java异常信息会被隐藏。这个问题影响了开发者调试和错误追踪的能力，因为无法获取完整的异常堆栈信息。

问题现象

当JavaScript代码通过Polyglot API调用Java方法时，如果：

1. 使用.mjs扩展名或模块MIME类型
2. 被调用的Java方法抛出异常

PolyglotException会隐藏原始Java异常信息，仅显示简化的"JavaObject[java.lang.RuntimeException]"信息，而不会显示原始异常消息和完整堆栈跟踪。

技术分析

这个问题源于GraalJS在模块模式下的异常处理机制。在模块模式下，GraalJS会创建一个Promise来处理模块加载，而当Java方法抛出异常时，这个异常会被Promise机制捕获并封装。在这个过程中，原始的Java异常信息没有被正确保留和传播。

从技术实现角度看，问题出现在异常解码环节。当GraalJS在ES模块模式下运行时，底层JVMCI（JVM Compiler Interface）无法正确解码异常对象，导致抛出InternalError: error decoding exception错误。

解决方案

Oracle GraalJS团队已经修复了这个问题，修复提交已经合并到master分支，并计划在24.2.2版本中发布。修复的核心是确保在模块模式下，Java异常能够被正确解码和传播。

临时解决方案

在官方修复版本发布前，开发者可以采用以下临时解决方案：

1. 不使用.mjs扩展名，改用.js扩展名
2. 不使用application/javascript+module MIME类型，改用application/javascript
3. 降级到GraalVM 24.1.0或更早版本

最佳实践

为了避免类似问题，建议开发者在集成GraalJS时：

1. 建立完善的异常处理机制，捕获并记录PolyglotException
2. 在关键业务逻辑中添加参数校验
3. 考虑实现自定义的异常转换层，确保异常信息的完整性
4. 定期关注GraalVM的版本更新和已知问题

总结

GraalJS作为强大的多语言运行时环境，在模块模式下处理Java异常时存在信息丢失的问题。这个问题已经在最新代码中得到修复，开发者可以通过临时解决方案规避问题，或等待官方发布修复版本。理解这个问题的本质有助于开发者更好地使用GraalVM的多语言能力，构建更健壮的跨语言应用。

对于依赖GraalJS模块功能的企业应用，建议在升级到24.2.0+版本前充分测试异常处理逻辑，或等待包含修复的稳定版本发布。