运行MediaPipe手部追踪代码报TypeError描述符无法直接创建如何解决

触发Descriptors cannot not be created directly报错的核心原因是protobuf版本不兼容：4.0及以上版本的protobuf不再支持旧版protoc生成的_pb2文件直接创建描述符，而当前安装的MediaPipe版本内置的协议生成文件是基于3.19.0以下版本protoc编译的，因此在执行import mediapipe as mp时直接抛出类型错误。

方案一：降级protobuf版本（优先推荐，无性能损耗） #

将protobuf依赖降级到3.20.x兼容版本即可，执行对应包管理工具的安装命令：

• pip环境执行：
  pip install protobuf==3.20.3
• conda环境执行：
  conda install protobuf=3.20.3
  安装完成后直接重新运行脚本即可正常导入MediaPipe，不影响原有手部追踪功能的运行效率。

方案二：设置环境变量走纯Python解析（临时应急用，存在明显性能损失） #

如果暂时无法调整依赖版本，可在代码最顶部、导入MediaPipe之前添加环境变量配置，强制使用纯Python实现的protobuf解析逻辑，修改后的代码开头如下：

import os
os.environ["PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION"] = "python"

import cv2
import mediapipe as mp
import time

cap = cv2.VideoCapture(0)
# 其余原有代码保持不变即可

注意：该模式下protobuf解析速度会大幅下降，实时手部追踪场景可能出现帧率降低、画面卡顿问题，不建议长期使用。

完成上述任意一种方案调整后，重新运行脚本，若摄像头正常拉起、画面中可以识别绘制手部关键点骨架、左上角实时显示FPS数值，即代表问题修复完成。

内容的提问来源于stack exchange，提问作者Swattik Kundu