[Bug] 不要固定依赖版本以及插件内部处理异常

[zouyonghe]

Plugin Version

latest

AstrBot Version

4.19.4

Database Type

SQLite (default)

Operating System

Linux

Bug Description

插件目前写死了依赖版本，例如aiohttp，很容易跟astrbot本体碰撞冲突，甚至导致本体依赖版本降级，建议去掉固定版本，以使uv等自动确定版本；另一方面，如果插件依赖安装失败，因为内部直接吞掉异常导致AstrBot无法正确处理插件状态，即使依赖缺失仍然被显示为正确加载

Steps to Reproduce

安装插件；重启AstrBot

Expected Behavior

安装插件依赖版本冲突直接失败（在AstrBot正在处理此问题）
重启AstrBot加载插件时，不应该即使报错也正常加载，如果接受容忍报错，应该更具体的针对缺失的组件处理，而不是在插件内部吞掉所有报错

Error Logs

Relevant Configuration

Additional Context

No response

[github-actions]

🤖 Issue 审查报告

优先级: 🟠 high

📋 用户处理意见

问题摘要: 插件在启动时会尝试导入/启用 WebUI（以及其依赖），如果你的 AstrBot 环境中已有不同版本的依赖（如 aiohttp），安装插件依赖可能触发版本冲突或降级；同时插件对依赖缺失/导入失败的异常处理不够严格，导致看起来“已加载”。

问题分类: 配置错误

建议操作：

1. 不要在 AstrBot 主环境里让该插件强制改动全局依赖：为 AstrBot 使用独立虚拟环境（venv/conda）后再安装插件，避免与系统/其它插件共享 site-packages。
2. 临时规避版本冲突：在插件配置中关闭 WebUI（如果你不需要 7833 管理页）。如果当前版本没有开关项，可先通过不加载 webui 模块的方式绕过（见下：开发者修复建议）。
3. 如果你需要 WebUI：请在 AstrBot 虚拟环境中手动安装与你当前 AstrBot 兼容的 aiohttp 版本（不要使用插件写死的版本），然后重启 AstrBot；例如：pip install 'aiohttp>=3.8,<4'（具体范围以 AstrBot 本体依赖为准）。
4. 重启后检查 AstrBot 插件加载日志：确认没有 ImportError/ModuleNotFoundError；若仍显示“加载成功但功能不可用”，请补充 AstrBot 控制台日志/插件日志以便定位。

---

🔧 开发者修复建议（点击展开）

技术摘要: 插件依赖不应在插件侧写死版本并影响宿主（AstrBot）依赖解析；同时启动/生命周期内存在“吞异常”或未将依赖缺失上报为加载失败的问题，导致 AstrBot 误判插件状态。

相关模块: webui, plugin lifecycle, dependency management

相关文件: webui/dependencies.py, webui/server.py, webui/manager.py, core/plugin_lifecycle.py, main.py, exceptions.py

根因分析: 从现象看是两类问题：1) 依赖声明/安装策略将 aiohttp 等关键依赖固定到特定版本，可能触发 pip 回退/降级宿主已安装版本；2) 插件启动链路对可选模块（尤其 WebUI）导入或依赖检测失败的异常处理过宽（例如 try/except Exception 后仅日志或忽略），使 AstrBot 的插件生命周期仍返回“成功加载”。相关点很可能集中在 webui 启动与插件生命周期管理：webui/server.py、webui/dependencies.py、core/plugin_lifecycle.py、main.py。

修复建议: 1) 依赖策略：将 aiohttp 等与宿主高度耦合的依赖改为“最小版本范围”而非固定版本，并尽量让其成为可选 extra（例如 webui extra）；避免在运行时自动安装/强制升级降级宿主依赖。2) 启动健壮性：为 WebUI 引入显式依赖探测函数（如 webui/dependencies.py 中检查 importlib.util.find_spec 或 importlib.metadata.version），缺失则：a) 若 WebUI 为可选功能，则禁用 WebUI 并在 WebUI 页面/日志提示“依赖缺失”；b) 若配置要求启用 WebUI，则在插件初始化阶段抛出自定义异常（例如 exceptions.py 定义 DependencyMissingError），让 core/plugin_lifecycle.py 识别并将插件标记为加载失败。3) 禁止吞异常：在 main.py / core/plugin_lifecycle.py 的初始化入口，细分捕获（ImportError/ModuleNotFoundError/VersionConflict/RuntimeError），记录完整堆栈并向 AstrBot 返回失败状态；仅对非关键功能使用降级策略。

---

Note

信息不完整 — 请补充以下信息以便我们更快地处理：

• reproduction_steps
• actual_behavior
• logs

---

_{🤖 此报告由 AI 自动生成，已分析仓库源码，仅供参考。开发者会尽快审阅您的 issue。}

[NickCharlie]

@zouyonghe 收到，感谢佬提出的意见，下个版本会进行修改