MediaPipe Tasks-GenAI Web 版本中 requestAdapterInfo 弃用问题解析

问题背景

MediaPipe Tasks-GenAI 是一个用于在浏览器中运行大型语言模型推理的 JavaScript 库。近期，在 Chrome 浏览器 132.0.6807.0 版本中，开发者报告了一个关键错误：当尝试初始化 LlmInference 时，系统抛出 "TypeError: a.requestAdapterInfo is not a function" 异常。

技术原因分析

这个问题的根源在于 WebGPU API 的变更。MediaPipe Tasks-GenAI 0.10.18 版本依赖的 requestAdapterInfo 方法已被 Chrome 团队标记为废弃。该方法原本用于获取 GPU 适配器的详细信息，但在最新规范中已被移除。

WebGPU 是新一代的图形 API，旨在为 Web 提供现代 GPU 功能。随着规范的演进，某些 API 接口会发生变化。在这种情况下，requestAdapterInfo 被更直接的信息获取方式所取代。

影响范围

此问题主要影响：

1. 使用 MediaPipe Tasks-GenAI 0.10.18 版本的 Web 应用
2. 运行在 Chrome 132+ 版本的浏览器环境
3. 需要 GPU 加速的 LLM 推理场景

解决方案

MediaPipe 团队已于 10 月 31 日提交修复代码，更新了 GPU 信息获取方式以适应新的 WebGPU 规范。开发者可以通过以下方式解决：

1. 使用最新的 nightly 构建版本（0.10.18-rc.20241108）
2. 等待下一个稳定版本发布

最佳实践建议

对于依赖 WebGPU 的开发者，建议：

1. 定期关注 WebGPU 规范变化
2. 在项目中加入浏览器版本检测机制
3. 考虑使用特性检测而非直接调用可能变更的 API
4. 保持依赖库的及时更新

总结

Web 技术生态的快速演进既带来新功能，也伴随着 API 变更的挑战。MediaPipe 团队对此类问题的快速响应体现了对开发者体验的重视。作为开发者，理解底层技术规范的变更趋势，建立灵活的应对机制，是构建稳定 Web 应用的关键。

对于 MediaPipe Tasks-GenAI 用户，及时更新到修复版本即可解决此问题，继续享受高效的浏览器端 LLM 推理能力。