Emscripten项目中emrun功能失效问题分析与修复

在Emscripten 4.0.3和4.0.4版本中，开发者发现了一个影响emrun工具正常工作的关键问题。emrun是Emscripten提供的一个重要工具，它允许开发者在浏览器中运行WebAssembly应用并捕获其输出，但在新版本中却无法正常工作。

问题现象

当开发者使用emrun运行通过Emscripten编译的WebAssembly应用时，会收到错误提示："The html page you are running is not emrun-capable"。具体表现为：

1. 无法捕获应用的stdout和stderr输出
2. 无法获取应用的退出状态码
3. 控制台会显示"addOnExit is not defined"的错误

问题根源

经过深入分析，发现问题源于Emscripten代码库中的一系列重构变更。在之前的版本中，addOnExit函数是直接可用的，但在重构过程中，这个函数被移动到了JS库中，而emrun_postjs.js脚本仍然尝试直接调用这个函数。

关键的变化包括：

1. 代码重构统一了最小运行时和普通运行时的初始化逻辑
2. 将所有addOnX系列函数移动到了JS库中
3. 链接阶段没有自动包含必要的库函数

解决方案

修复方案相对简单但有效：在链接阶段确保包含$addOnExit函数。具体修改是在tools/link.py文件中，当检测到--emrun标志时，将$addOnExit添加到DEFAULT_LIBRARY_FUNCS_TO_INCLUDE设置中。

这个修复确保了：

1. emrun_postjs.js能够找到所需的addOnExit函数
2. 应用退出时的清理工作能够正常执行
3. 输出捕获功能恢复正常

影响范围

该问题影响：

1. 使用Emscripten 4.0.3和4.0.4版本编译的项目
2. 依赖emrun进行自动化测试或输出捕获的场景
3. 需要获取WebAssembly应用退出状态码的用例

临时解决方案

对于无法立即升级的用户，可以手动修改本地Emscripten安装中的link.py文件，添加相应的代码行来临时解决问题。但建议尽快升级到包含修复的版本。

最佳实践

为避免类似问题，开发者应该：

1. 定期更新Emscripten工具链
2. 在CI/CD流程中加入emrun的功能测试
3. 关注Emscripten的变更日志，特别是涉及核心功能的修改

这个问题展示了即使是成熟工具链中的小变更也可能产生连锁反应，强调了全面测试的重要性。Emscripten团队快速响应并修复了这个问题，体现了开源社区的高效协作。