MediaPipe Tasks Vision在Mac Chrome Web Worker中的崩溃问题分析

问题背景

MediaPipe是一个由Google开发的多媒体机器学习框架，其中的Tasks Vision模块提供了计算机视觉相关的预构建任务。近期发现，在Mac系统上的Chrome浏览器(版本128)中，当尝试在Web Worker环境下运行Tasks Vision模块时，会出现崩溃问题。

问题根源

经过分析，问题的根本原因在于平台检测逻辑中存在对document对象的错误依赖。具体来说，代码中有一处检查：

navigator.userAgent.includes("Mac") && "ontouchend" in document

这段代码原本用于检测Mac平台上的触摸事件支持情况。然而，在Web Worker环境中，全局作用域中并不存在document对象，导致这段代码抛出异常。

技术细节

1. Web Worker环境特性：Web Worker运行在独立的线程中，与主线程隔离，因此无法访问DOM相关的API，包括document对象。

2. 平台检测逻辑：MediaPipe的platform_utils.ts文件中包含了对不同平台的检测逻辑，其中Mac平台的检测不仅检查用户代理字符串，还尝试检查触摸事件支持。

3. 错误传播：当这段检测代码在Web Worker中执行时，由于document未定义，导致整个任务初始化失败。

解决方案

修复方案相对直接：

1. 修改平台检测逻辑，确保在Web Worker环境下不会尝试访问document对象。
2. 使用更安全的检测方式，例如先检查document是否存在，再进行属性检测。

最终采用的修复代码类似于：

navigator.userAgent.includes("Mac") && self.document && "ontouchend" in self.document

这种写法首先检查self.document是否存在，然后再进行属性检测，避免了在Web Worker环境下的崩溃问题。

影响范围

这个问题主要影响：

• 使用MediaPipe Tasks Vision 0.10.6及更早版本
• 在Mac系统上的Chrome浏览器
• 在Web Worker环境中运行的场景
• 特别是使用Image Segmenter任务的应用程序

版本更新

该问题已在MediaPipe Tasks Vision 0.10.15版本中得到修复。建议所有在Web Worker中使用该库的开发者升级到最新版本。

开发者建议

对于需要在Web Worker中使用计算机视觉功能的开发者，建议：

1. 始终使用最新版本的MediaPipe库
2. 在Web Worker中初始化任务时，做好错误捕获
3. 考虑主线程和Worker线程之间的通信开销
4. 对于性能敏感的应用，可以预先测试不同环境下的执行效率

这个问题也提醒我们，在编写跨环境(主线程/Worker)的JavaScript代码时，需要特别注意对DOM API的依赖，确保代码在隔离环境下也能正常运行。