故障排除指南

本章节收录用户在使用 AIVT-OV 工具包过程中常见的错误类型与解决方法，覆盖安装、激活、模型运行、图像采集与部署阶段的典型问题。

如您遇到以下问题，可优先参考本页内容；如仍无法解决，请联系技术支持。

一、安装与激活类问题

问题描述 可能原因 解决方案
工具包安装后 LabVIEW 无法加载函数面板 未正确安装 VIPM 包或未重启 LabVIEW 请重新安装 .vip 包，安装后重启 LabVIEW
License Manager 启动异常或界面不显示 工具包未正确注册，依赖未加载 重新运行 LabVIEW，以管理员身份打开
激活时提示“Activate failed” License ID/Key 输入错误或网络异常 检查 ID 和 Key 是否正确；确保已经联网
离线激活时无法识别 .lic 文件 文件路径错误或绑定设备不符 确保 .lic 来自官方、与本机 Computer ID 一致；路径无中文空格

二、模型运行类问题

问题描述 原因 解决方案
模型推理 VI 报错 模型路径无效或模型格式不兼容 检查模型路径是否正确，推荐使用英文路径，无中文
推理结果为空，未检测到任何目标 输入图像尺寸不符 / 类别文件错误 检查模型输入尺寸是否为1×3×HxW，类别文件是否每行一类
OpenVINO 模型加载失败 模型结构不标准 / 输入通道不对 建议使用 Netron 查看模型结构或更换官方提供的示例模型
推理卡顿或速度过慢 使用 CPU 推理或分辨率过大 可切换到 GPU 推理设备（Intel A770/iGPU），或调整图像尺寸

三、图像采集类问题

问题描述 可能原因 解决方案
摄像头画面无法打开 未连接或驱动异常 检查设备管理器；尝试使用 USB 相机，查看是否可用电脑自带的相机软件打开摄像肉
视频文件读取失败 路径不对或文件格式不支持 建议使用 .mp4、.avi 格式；路径为绝对路径
相机画面黑屏但无报错 相机连接成功但图像通道错误 尝试更换通道编号；确认相机分辨率与帧率设置合理
工业相机采集无响应 未加载厂商驱动或未初始化 安装相应品牌SDK并确认 LabVIEW 调用接口初始化正常

四、部署运行类问题

问题描述 原因 解决方案
打包后的 EXE 启动闪退 模型路径错误或缺少依赖 检查是否包含所有模型/类别名/图像文件等；可加日志记录排查
部署端无法加载 License Manager 缺少运行库或未包含 VI 依赖 打包时确保依赖项勾选完整，推荐使用 Installer 打包
EXE 运行后提示“未授权运行” 未进行部署激活或激活失败 请参见 项目部署与分发 执行部署授权流程

五、路径与文件类问题

问题描述 原因 解决方案
程序运行找不到模型或类别名文件 模型路径写死为开发机路径 改为使用控件传入相对路径，避免路径硬编码
模型路径为中文时报错 OpenVINO 加载路径不支持中文 所有路径应为英文文件夹；避免空格和中文字符
图片集选择无法显示图像 图片格式不支持或路径错误 支持 .jpg/.png 等常见格式

🛠 排查建议流程

➊ 是否加载了模型？→ 模型路径是否正确？ ➋ 是否正常采集图像？→ 相机或图像路径是否有效？ ➌ 是否输出推理结果？→ 输入维度、类别文件是否正确？ ➍ 是否报错？→ 查看 VI 报错信息并定位对应函数 ➎ 是否授权？→ 检查许可证激活状态

其他排查辅助

  • 可在 VI 中增加“日志记录”模块，输出模型路径、设备状态等关键运行信息

  • 建议添加前面板“Debug”模式，用于输出中间结果图像或中间变量

  • 在部署程序中保留错误提示窗口，有助于用户现场定位问题

技术支持

若仍无法解决问题，请联系技术支持团队：

提交问题时请附带以下信息：

  • 当前使用的 LabVIEW 版本与位数（如 2021 SP1 64-bit）

  • 操作系统版本（如 Windows 10 22H2 x64）

  • 所用工具包版本号（可在“更新记录”或VIPM中查看）

  • 出现问题的具体模块（如 OpenVINO / ModelZoo / PaddleOCR 等）

  • 问题截图或报错信息

  • 如为模型加载问题，请附上模型文件路径和模型结构截图（可用 netron.app 查看）

📌 建议您在邮件标题中注明“[AIVT-OV故障咨询]”，我们将优先响应。

感谢您的支持与理解。