[Bug] [ERRO] [v4.22.0] [core.plugin_lifecycle:78]: 创建对话目标管理器失败: module 'openai' has no attribute 'exceptions'

[siraibkkuroko]

Plugin Version

2.0.6

AstrBot Version

4.22.0

Database Type

SQLite (default)

Operating System

Windows

Bug Description

win11，DOCKER里部署的ASTRBOT

[2026-03-23 04:31:22.832] [Plug] [ERRO] [v4.22.0] [core.plugin_lifecycle:78]: 创建对话目标管理器失败: module 'openai' has no attribute 'exceptions'
Traceback (most recent call last):
File "/AstrBot/data/plugins/astrbot_plugin_self_learning/core/plugin_lifecycle.py", line 74, in bootstrap
component_factory.create_conversation_goal_manager()
File "/AstrBot/data/plugins/astrbot_plugin_self_learning/core/factory.py", line 34, in wrapper
result = func(self, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/AstrBot/data/plugins/astrbot_plugin_self_learning/core/factory.py", line 972, in create_conversation_goal_manager
service = ConversationGoalManager(
^^^^^^^^^^^^^^^^^^^^^^^^
File "/AstrBot/data/plugins/astrbot_plugin_self_learning/services/quality/conversation_goal_manager.py", line 286, in init
from ...utils.guardrails_manager import get_guardrails_manager, GoalAnalysisResult, ConversationIntentAnalysis
File "/AstrBot/data/plugins/astrbot_plugin_self_learning/utils/guardrails_manager.py", line 7, in
from guardrails import Guard
File "/usr/local/lib/python3.12/site-packages/guardrails/init.py", line 3, in
from guardrails.guard import Guard
File "/usr/local/lib/python3.12/site-packages/guardrails/guard.py", line 8, in
from guardrails.llm_providers import PromptCallable, get_llm_ask
File "/usr/local/lib/python3.12/site-packages/guardrails/llm_providers.py", line 18, in
openai.exceptions.APIError,
^^^^^^^^^^^^^^^^^
AttributeError: module 'openai' has no attribute 'exceptions'. Did you mean: '_exceptions'?
豆包说是POENAI版本太新了，我不清楚是ASTRBOT还是插件的原因。
之前用命令安装过依赖包全套

Steps to Reproduce

重载插件就出现了，应该书安装后就报错。

Expected Behavior

希望不报错，又解决办法。

Error Logs

Relevant Configuration

Additional Context

No response

[github-actions]

🤖 Issue 审查报告

优先级: 🟠 high

📋 用户处理意见

问题摘要: 插件在初始化对话目标管理器时会引入 guardrails-ai，而 guardrails-ai 依赖旧版 OpenAI Python SDK 的 openai.exceptions；你当前容器里安装的是新版 openai（仅有 _exceptions），导致 AttributeError 并使该模块初始化失败。

问题分类: 缺少依赖

建议操作：

1. 进入 AstrBot 容器（或插件运行的同一 Python 环境）确认 openai 版本：python -c "import openai; import pkgutil; print('openai', getattr(openai,'__version__', 'unknown')); print('has exceptions', hasattr(openai,'exceptions'));"
2. 将 openai 降级到 guardrails 兼容的 0.x 版本（常用可行组合）：pip install -U "openai<1"
3. 如果你是 Docker 部署：把上述版本约束写入你的镜像构建过程（Dockerfile/requirements），然后重新构建镜像并重启容器，避免重启后又被装回新版
4. 重载插件/重启 AstrBot，确认错误消失
5. 若你必须使用 openai>=1（其他组件要求），可改用“禁用 guardrails 相关功能”的方式绕开（见开发者修复建议：需要插件提供配置开关/可选依赖）；当前版本 2.0.6 仍会在创建 ConversationGoalManager 时强制 import guardrails，因此只能通过降级 openai 或卸载 guardrails 相关依赖来解决

---

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

技术摘要: guardrails-ai 与 openai>=1 的 API 不兼容，插件在 ConversationGoalManager 初始化阶段无条件 import guardrails，导致在 openai 新版环境中启动即失败。

相关模块: quality, utils, core.factory, plugin_lifecycle

相关文件: services/quality/conversation_goal_manager.py, utils/guardrails_manager.py, core/factory.py, core/plugin_lifecycle.py, requirements.txt

根因分析: 在 services/quality/conversation_goal_manager.py 的 init（约 line 286）执行 from ...utils.guardrails_manager import ...，而 utils/guardrails_manager.py 顶部 from guardrails import Guard 会触发 guardrails/llm_providers.py 引用 openai.exceptions.APIError；openai>=1 已将 exceptions 移到 openai._exceptions（且不再暴露 openai.exceptions），因此抛出 AttributeError: module 'openai' has no attribute 'exceptions' 并中断插件 bootstrap（core/plugin_lifecycle.py:74 -> core/factory.py:create_conversation_goal_manager）。最近提交 412f80f 移除了 requirements 版本锁，放大了该兼容性问题（环境更容易装到 openai 新版）。

修复建议: 1) 恢复/补充依赖版本约束：在 requirements.txt（或插件依赖声明处）明确 pin：guardrails-ai 对应的兼容 openai 版本（例如 openai<1），或将 guardrails-ai 升级到支持 openai>=1 的版本并一起 pin（需要验证 guardrails 版本是否已适配）。
2) 让 guardrails 成为“可选依赖”并做降级：修改 utils/guardrails_manager.py 将 from guardrails import Guard 改为 try/except ImportError/AttributeError，并在失败时返回一个 no-op/纯 pydantic 校验的实现；同时在 services/quality/conversation_goal_manager.py（init）延迟初始化 guardrails：仅当配置启用（如 config.enable_guardrails）才 import/创建，否则跳过。
3) 增加启动健壮性：在 core/factory.py:create_conversation_goal_manager 包裹 ConversationGoalManager 构造，捕获 AttributeError/ImportError 并记录警告后禁用该模块，而不是让整个插件 bootstrap 失败。

---

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

[siraibkkuroko]

按照豆包使用2＋3修复了。方案1无法在DOCKER里运行会报错，Docker 里依赖冲突，lightrag/mem0 强制要求 openai >=1。
最终结论现在的环境，永远无法让 “对话目标管理模块” 正常工作。
原因：
lightrag、mem0ai 强制要求 openai >= 1.0
guardrails-ai 不支持 openai >= 1.0
两者死冲突，无解
所以：
** 官方所有建议 + 任何修复方法，都不能让这个模块在你环境里恢复功能。
除非你卸载 lightrag /mem0ai。**

=============================================================
以下是2＋3修复方法
严格按照开发者官方建议 2+3 执行，不降级依赖、不崩溃插件、保留核心功能

一、问题根源

• openai >= 1.0 与 guardrails-ai 不兼容
• 插件启动时直接导入 guardrails，触发 AttributeError 导致崩溃
• Docker 内依赖冲突，无法使用 openai < 1.0

---

二、一共修改 3 个文件

1. 修改：utils/guardrails_manager.py

作用：捕获导入异常，让 guardrails 变成可选依赖

# 原代码
from guardrails import Guard

# 改为
try:
from guardrails import Guard
except (ImportError, AttributeError):
Guard = None

---

2. 修改：services/quality/conversation_goal_manager.py

作用：延迟初始化 + 异常捕获，加载失败不崩溃

# 原代码
from ...utils.guardrails_manager import get_guardrails_manager, GoalAnalysisResult, ConversationIntentAnalysis
self.guardrails = get_guardrails_manager()
self.GoalAnalysisResult = GoalAnalysisResult
self.ConversationIntentAnalysis = ConversationIntentAnalysis

# 改为整块包裹 try
try:
from ...utils.guardrails_manager import get_guardrails_manager, GoalAnalysisResult, ConversationIntentAnalysis
self.guardrails = get_guardrails_manager()
self.GoalAnalysisResult = GoalAnalysisResult
self.ConversationIntentAnalysis = ConversationIntentAnalysis
except Exception:
self.guardrails = None
self.GoalAnalysisResult = None
self.ConversationIntentAnalysis = None

---

3. 修改：core/factory.py

作用：捕获初始化异常，只警告、不抛错、不炸插件

# 原代码
except ImportError as e:
self._logger.error(f"导入对话目标管理器失败: {e}", exc_info=True)
raise ServiceError(f"创建对话目标管理器失败: {str(e)}")

# 改为
except (ImportError, AttributeError) as e:
self._logger.warning(f"对话目标管理器初始化失败，已自动禁用（兼容修复）: {e}")
return None

---

三、重启生效

docker restart astrbot

或在面板点击 重载插件

---

四、最终效果

✅ 不再出现 module 'openai' has no attribute 'error'
✅ self-learning 插件正常启动、核心功能完整可用
✅ 仅对话目标管理模块自动跳过
✅ 日志仅警告，不崩溃、不中断启动

[NickCharlie]

你好，最近非常忙，可能不太能及时处理问题。你的反馈我已经收到了，不好意思

[DreamFerry]

从日志分析了下，原因在于Astrbot要求click >= 8.2.1，而新版guardrails-ai要求click<=8.2.0，这导致pip会为了兼容而选择安装guardrails-ai-0.1.8，这个版本虽然对依赖没做要求但太老了不支持openai >= 1.0（Astrbot要求openai>=1.78.0）
我不管guardrails-ai的依赖要求强制升级到最新版了，目前使用倒是正常了

[LDX2007]

在新建的实例仅放入data文件夹，它全部自动安装了一遍环境就莫名的好了，没有任何报错。