故障排查
本篇按故障现象给出逐项处理步骤,覆盖插件加载、控制台打开、图片生成与发送、群开关异常等场景。
🧭 排查速查
| 现象 | 对应章节 |
|---|---|
| 提示加载失败 0011 | 插件加载失败 0011 |
| 设置页面打不开 / WebView2 启动失败 | 设置页面打不开 |
| 群内返回文字资料而非图片 | 图片生成失败 |
| 图片发送不出来 | 图片发送失败 |
| 群开关开启但无响应 | 群开关显示开启但不响应 |
一般性疑问(如显示为 QQ 号、等级不符)请先查阅常见问题FAQ。
🧩 插件加载失败 0011
如果提示无法加载文件或程序集:
- 确认使用完整的
.uniqq安装包,而不是只复制 DLL; - 删除旧版插件后重新导入正式包;
- 确认包内包含 WebView2 相关 DLL 和
runtimes目录; - 重启 UniQQ 后再次启用。
🖥️ 设置页面打不开
- 安装 Microsoft Edge WebView2 Runtime;
- 确认插件包内存在
Web/index.html、Web/app.js和Web/style.css; - 检查安全软件是否隔离 WebView2Loader.dll;
- 重启 UniQQ。
🎨 图片生成失败
图片生成失败时,插件会自动返回文字资料,功能不会中断。继续检查:
- 数据目录是否有写入权限;
- 磁盘空间是否充足;
- 头像文件是否损坏;
Assets/qq-level是否包含四种等级图标;- UniQQ 日志中的完整异常信息。
📤 图片发送失败
- 确认机器人有群内发图权限;
- 确认生成的图片路径存在;
- 检查协议端是否能发送本地图片;
- 尝试发送普通图片,判断是否为框架通道问题。
🏘️ 群开关显示开启但不响应
- 点击「保存并生效」;
- 重新读取配置,确认开关仍为开启;
- 检查是否选择了「仅开启所选群」;
- 检查配置文件中该群是否同时存在于禁用列表;
- 使用新版控制台重新关闭再开启该群,插件会自动清理冲突。
群组范围与两种策略的行为说明见群组范围与独立开关。
📮 收集问题信息
联系作者或加入官方群反馈时,建议同时提供:
- UniQQ 版本;
- 插件版本;
- 机器人协议端名称和版本;
- 问题发生时间;
- 相关日志;
- 设置页面截图;
- 是否能够稳定复现。
信息安全
请勿公开发送账号密码、密钥、登录凭证或其他敏感信息。
官方支持渠道
- 作者:小林&薇薇(QQ:939921104)
- 官方群:327942687
- 官网:https://blog.zxiaolin.com
📚 下一节:升级备份与版本记录
