PCM_Viewer/TROUBLESHOOTING.md

故障排除指南

QtQuick 插件加载失败

如果遇到以下错误：

无法加载库 ... qtquick2plugin.dll：找不到指定的模块。

解决方案 1：安装 Visual C++ Redistributable

这是最常见的原因。请下载并安装：

• Visual C++ Redistributable 2015-2022 (x64)
  • 下载地址：https://aka.ms/vs/17/release/vc_redist.x64.exe
  • 安装后重启计算机

解决方案 2：重新安装 PySide6

pip uninstall PySide6 PySide6-Essentials PySide6-Addons -y
pip install PySide6==6.7.0

解决方案 3：检查系统环境

确保系统 PATH 环境变量中包含必要的路径，或者尝试在管理员权限下运行程序。

解决方案 4：使用虚拟环境

创建一个新的虚拟环境并重新安装：

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

其他常见问题

模块导入错误

如果遇到 ModuleNotFoundError，请确保：

1. 已安装所有依赖：pip install -r requirements.txt
2. Python 版本兼容（推荐 Python 3.8+）

InfluxDB 连接问题

如果无法连接到 InfluxDB：

1. 检查 InfluxDB 服务是否运行
2. 验证 URL、Token、Organization 和 Bucket 配置
3. 检查网络连接和防火墙设置