install plugin error

用户在 Dify 1.13 Docker 自托管环境中,尝试安装名为 ivan97/repair_json:0.0.2 的插件时,系统返回 PluginDaemonInternalServerError 错误,导致安装失败。

install plugin error

install plugin error

快速结论:该报错通常发生在 Dify 1.13 自托管(Docker)部署中,当 API 与 dify-plugin-daemon 容器版本不匹配时触发。优先排查并升级 dify-plugin-daemon0.5.6-local 或更高版本

问题场景

用户在 Dify 1.13 Docker 自托管环境中,尝试安装名为 ivan97/repair_json:0.0.2 的插件时,系统返回 PluginDaemonInternalServerError 错误,导致安装失败。

报错原文

[ERROR]PluginDaemonInternalServerError: plugin not found
goroutine 433 [running]:
runtime/debug.Stack()
	/usr/local/go/src/runtime/debug/stack.go:26 +0x5e
github.com/langgenius/dify-plugin-daemon/internal/types/exception.InternalServerError({0x2724da0, 0x3aa0f90})
	/app/internal/types/exception/factory.go:27 +0x27
github.com/langgenius/dify-plugin-daemon/internal/service.InstallPluginFromIdentifiers(0xc000766008, {0xc00257642d, 0x24}, {0xc00095a2b0, 0x1, 0x1}, {0xc000195070, 0xb}, {0xc00008e3c0, 0x1, ...})
	/app/internal/service/install_plugin.go:333 +0x1ed

原因分析

根本原因是 Dify 1.13 中 API 与 dify-plugin-daemon 之间的 字段命名约定不匹配。新版本 API 使用 snake_case 格式发送 plugin_unique_identifier,而旧版 daemon(≤ 0.5.4)预期接收 PascalCase 格式的 PluginUniqueIdentifier。这种命名差异导致 daemon 无法正确解码插件标识符,从而抛出 plugin not found 错误。类似问题已在其他 Issue(#34263、#34167)中得到确认。

环境排查

  • 确认 Dify 版本是否为 1.13
  • 确认 dify-plugin-daemon 容器版本(检查 docker-compose.yaml 或 override 文件中的 image tag)
  • 确认 PLUGIN_DAEMON_URL 环境变量是否设置为 Docker 服务名(例如 http://plugin_daemon:5002),而非 localhost
  • 确认自托管实例是否能正常访问 marketplace.dify.ai:443(用于下载插件清单)

解决步骤

  1. 升级插件守护进程容器:运行以下命令拉取最新的 dify-plugin-daemon 镜像并重启容器。
    docker compose pull
    docker compose up -d

    确保正在运行的版本是 0.5.6-local 或更高版本

  2. 可选:手动安装插件(如果升级后问题仍未解决):从 marketplace 手动下载 .difypkg 文件,然后通过 Dify UI 中的 “Install from local file” 功能进行安装。
  3. 运行数据库迁移(升级 daemon 后执行):
    docker exec -it plugin_daemon /app/commandline migrate

    可优先尝试此步骤,确保数据库模式与新版 daemon 匹配。

  4. 验证 PLUGIN_DAEMON_URL 配置:检查环境变量,确保其值指向正确的 Docker 服务名,例如 http://plugin_daemon:5002,避免使用 localhost 导致连接失败。

验证方法

完成上述步骤后,重新尝试安装同一插件(或另一个测试插件)。如果安装成功且不再出现 plugin not found 错误,则说明问题已解决。同时,检查 Dify 日志确认无新的 PluginDaemonInternalServerError 记录。

参考来源

langgenius/dify #37275

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

celebrityanime
celebrityanime
文章: 7436

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注