[Bug]: 疑似由QQ图片url转base64请求超时导致的WebSocket断联&插件崩溃

[ZaylLahnma]

Runtime environment

v4.6.4, WindowsServer2022, python 3.11.4, 手动部署

Exception

协议端为LLOneBot

报错内容：

Reproduction steps

已确定（高概率频繁触发）：群聊中询问bot图片中内容，bot读取图片并且回复之后有较高概率触发此崩溃。询问方式是引用上一个回答中的图片。ps.直接用图片+文字发给bot没有任何反应，后台也没显示收到消息。
有可能（低概率，猜测）：在bot在QQ群A中读取图片分析的同时，在QQ群B中处理AllmagePlugin的图片生成时触发。

Enabled plugins

TaskTimer, AllmagePlugin, ScheNotify, TavilySearch

[dosubot]

Hi @ZaylLahnma! I'm Dosu and I’m helping the LangBot team.

你的分析是准确的：QQ图片 URL 转 base64 过程中如果请求超时，会导致插件异步任务被取消（asyncio.CancelledError），进而触发 WebSocket 心跳超时，最终导致插件运行时断开连接和崩溃。这种情况在图片处理较慢或 QQ 服务器响应慢/风控时更容易复现。

技术细节与根因说明：

• LangBot 的图片下载和 base64 转换（如 qq_image_url_to_base64）使用 aiohttp，单次请求超时时间为 15 秒，没有自动重试机制。如果网络慢、图片大或 QQ 端风控，容易超时抛异常，异常会沿调用链上传递，最终导致插件任务被取消（CancelledError），WebSocket 心跳丢失，触发断联【参考源码1】。
• 插件运行时与主进程通过 WebSocket 通信，心跳每 20 秒一次。如果插件处理阻塞或超时，心跳无法及时响应，WebSocket 会因 keepalive 超时（1011）断开，且 Windows 下无法自动重连【参考源码2】。
• 插件 SDK 层面对长时间操作（如命令、工具调用）有 180 秒超时保护，超时会强制取消任务，表现为 CancelledError，并触发插件容器清理，需重启服务恢复【参考源码3】。

建议与缓解措施：

1. 优化图片处理链路：如有条件，建议在插件层面（如 AllmagePlugin）对图片下载失败/超时做异常捕获和降级处理，避免异常冒泡到主流程导致整个插件崩溃。
2. 减少并发图片处理：避免同一时刻大量图片识别/生成请求，降低 QQ 端风控概率和本地网络压力。
3. 监控和重启机制：生产环境建议用 supervisor、systemd 等守护进程自动拉起 LangBot，减少人工介入。
4. 升级与关注后续修复：近期 LangBot 已将命令超时从 60s 提升到 180s，减少误杀长任务，但根本问题仍需插件/业务层优化（如重试、异常捕获）【PR 1813】。
5. 如遇频繁风控：可尝试更换网络环境、代理或账号，或延迟重试，避免短时间高频访问 QQ 图片接口。

参考：

• LangBot 插件运行时连接与心跳机制源码
• 图片下载/转 base64 超时与异常处理源码
• 插件 SDK 超时与断链处理源码
• PR 1813: 命令超时提升至 180s

如需进一步定位，可在插件层加 try/except 捕获图片处理异常，或开启更详细日志，定位具体是哪一步骤超时。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[ZaylLahnma]

重新编辑了问题，补充触发步骤：“群聊中询问bot图片中内容，bot读取图片并且回复之后有较高概率触发此崩溃。”之后
增加了：“询问方式是引用上一个回答中的图片。ps.直接用图片+文字发给bot没有任何反应，后台也没显示收到消息。”