WebUI项目在MacOS M2上的高CPU负载问题分析与解决

问题背景

WebUI是一个跨平台的轻量级Web界面库，允许开发者使用简单的HTML/CSS/JavaScript创建原生应用界面。在最新发布的2.5.0-beta.3版本中，开发者在MacOS Sequoia 15.3系统上的M2芯片设备上发现了一个严重性能问题：应用运行时CPU占用率持续高达100%，且无法正常退出应用。

问题现象

开发者报告的主要症状包括：

1. 无论以何种方式运行应用（Xcode调试、独立运行Debug/Release版本），CPU使用率都维持在100%
2. 点击窗口关闭按钮后，窗口会关闭但进程仍在后台运行且持续占用高CPU
3. 应用卡在webui_wait()函数中无法继续执行
4. 无法通过Dock图标重新打开已关闭的窗口

技术分析

通过代码审查和调试日志分析，发现问题根源在于WebUI的macOS实现中存在两个关键缺陷：

1. 渲染循环设计问题：webui_wait()函数在macOS平台上实现了一个主动轮询循环，不断调用Objective-C层的_webui_macos_wv_process()函数来处理WebView渲染。这种设计在Windows和Linux上工作正常，但在macOS的WebKit实现中导致了不必要的CPU负载。

2. 事件处理机制缺陷：关闭窗口时，macOS的WebView没有正确触发退出标志，导致webui_wait()循环无法检测到退出条件，从而卡死。

解决方案

开发团队通过以下方式解决了这些问题：

1. 重构渲染循环：将主动轮询改为基于事件的回调机制，仅在需要时处理渲染更新，大幅降低了CPU使用率。

2. 完善退出处理：增强macOS平台特定的窗口关闭事件处理，确保正确设置退出标志，使webui_wait()能够及时检测并退出循环。

3. 增加平台适配层：针对macOS的WebKit实现添加了特殊处理，优化了资源使用效率。

验证结果

修复后的版本经过测试确认：

• CPU使用率恢复正常水平
• 窗口关闭后应用能够正确退出
• 所有功能保持正常运作
• 性能表现符合预期

技术启示

这个案例展示了跨平台开发中的常见挑战：

1. 不同平台底层实现的差异可能导致相同的代码表现出完全不同的行为
2. GUI事件处理需要特别注意平台特定行为
3. 性能优化需要针对每个平台进行针对性调整

WebUI团队通过快速响应和深入分析，不仅解决了具体问题，还增强了框架的跨平台稳定性，为后续开发提供了宝贵经验。