MediaPipe 新版 API 已弃用 `solution` 属性，改用 `task` API。若需恢复 `solution` 接口，需进行版本降级。 ### 1. 问题根源：API 迁移 自 MediaPipe 0.10.x 版本后，Google 重构了 API，将原先通过 `mp.solutions` 访问的模块（如 `mp.solutions.pose`）迁移至新的 `tasks` 和 `vision` 命名空间下。旧版代码直接导入 `solution` 会触发 `AttributeError`，因为该属性在新版中已不存在 [ref_5]。 ### 2. 解决方案对比 | 方案 | 操作步骤 | 优点 | 缺点 | 适用场景 | | :--- | :--- | :--- | :--- | :--- | | **降级安装旧版** | 卸载新版，安装 `mediapipe==0.10.14` | 完全兼容旧代码，无需修改 | 无法使用新版功能与优化 | 维护旧项目，急需快速运行 | | **升级代码至新版** | 改用 `tasks` API 重写相关代码 | 使用最新特性与性能优化 | 需要修改现有代码 | 新项目或愿意升级的旧项目 | ### 3. 方案一：降级安装 MediaPipe 0.10.14（推荐快速修复） 执行以下命令完成降级： ```bash # 卸载当前版本 pip uninstall mediapipe -y # 安装指定旧版本 pip install mediapipe==0.10.14 ``` 降级后，旧代码即可正常运行。例如，原本的人体姿态检测代码： ```python import cv2 import mediapipe as mp # 降级后，solution属性恢复可用 mp_pose = mp.solutions.pose pose = mp_pose.Pose() # 处理图像的代码... ``` ### 4. 方案二：迁移代码至新版 Task API 新版 API 设计更模块化。以人体姿态检测为例，旧版与新版的代码对比如下： **旧版 (0.10.14 及之前) 代码示例：** ```python import cv2 import mediapipe as mp mp_drawing = mp.solutions.drawing_utils mp_pose = mp.solutions.pose with mp_pose.Pose(min_detection_confidence=0.5, min_tracking_confidence=0.5) as pose: image = cv2.imread('test.jpg') results = pose.process(cv2.cvtColor(image, cv2.COLOR_BGR2RGB)) if results.pose_landmarks: mp_drawing.draw_landmarks(image, results.pose_landmarks, mp_pose.POSE_CONNECTIONS) ``` **新版 (0.10.15 及之后) 代码示例：** ```python import cv2 import mediapipe as mp from mediapipe import tasks from mediapipe.tasks import python from mediapipe.tasks.python import vision # 1. 创建选项 base_options = python.BaseOptions(model_asset_path='pose_landmarker.task') options = vision.PoseLandmarkerOptions(base_options=base_options, output_segmentation_masks=True) # 2. 创建检测器 detector = vision.PoseLandmarker.create_from_options(options) # 3. 处理图像 image = mp.Image.create_from_file('test.jpg') detection_result = detector.detect(image) # 4. 可视化结果 (注：新版绘图工具可能需从`solution`迁移，或使用自定义函数) ``` 新版 API 将模型、选项、执行分离，增强了灵活性，但需要调整代码结构并注意绘图工具可能需单独处理 [ref_5]。 ### 5. 附加问题：PyInstaller 打包处理 若在使用 PyInstaller 打包 MediaPipe 项目时遇到 `FileNotFoundError`（常见于资源文件丢失），需在打包时通过 `--add-data` 手动包含 MediaPipe 的依赖资源。例如，MediaPipe 可能需要 `*.task` 模型文件或 `*.pbtxt` 配置文件。可通过以下步骤定位并添加： ```bash # 首先找到mediapipe资源路径，例如在Python交互环境中： import mediapipe as mp print(mp.__file__) # 假设输出为 /path/to/site-packages/mediapipe # 使用PyInstaller打包时添加资源 pyinstaller --add-data "/path/to/site-packages/mediapipe/*.task:mediapipe" \ --add-data "/path/to/site-packages/mediapipe/*.pbtxt:mediapipe" \ your_script.py ``` 此操作确保打包后的可执行文件能访问必要的运行时数据文件 [ref_4][ref_6]。 **总结**：`找不到solution` 的直接原因是版本不匹配。最快捷的解决方法是降级至 `0.10.14`。若计划长期维护项目，建议参照官方文档将代码迁移至新的 `tasks` API，以利用持续更新和支持。