快速结论:这个报错通常出现在从旧版本升级到 Dify 1.17.0 之后,打开应用调用插件管理的 management/tools 接口时。优先排查 plugin_daemon 容器镜像是否仍停留在旧版本,而 API 已经升到了 1.17.0。
适用环境:Dify 1.17.0,Self Hosted(Docker),从 1.16.0 升级而来。Issue 未提供操作系统、Python、CUDA、显卡等环境信息。
最快修复方案:把 docker-compose.yaml 里的 plugin_daemon 镜像改为 Dify 1.17.0 对应的 langgenius/dify-plugin-daemon:0.6.10-local,然后执行 docker compose up -d plugin_daemon 重启该容器。
注意事项:该方案来自社区回复的推断,Issue 中未见报告者确认已修复,属于可优先尝试的方向。升级前建议备份数据库和 docker-compose.yaml;如果镜像本身已经是 0.6.10-local,则问题可能另有原因,需要进一步查看 plugin_daemon 日志中实际返回的数据结构。
问题场景
用户把自托管 Docker 部署的 Dify 从 1.16.0 升级到 1.17.0。升级后先出现 'text-generation' is not a valid ModelType,按相关 Issue 执行更新 SQL 脚本后该报错消失。随后在打开应用时,前端开始报插件守护进程响应解析失败,涉及 plugin/{tenant_id}/management/tools 接口。
报错原文
ValueError: 'text-generation' is not a valid ModelType
Failed to parse response from plugin daemon to PluginDaemonBasicResponse [list], url: plugin/1557f938-1685-4342-a5bc-63bc84562831/management/tools
原因分析
最可能的原因是升级后 plugin daemon 版本不匹配。fetch_tool_providers 会调用 plugin/{tenant_id}/management/tools,并期望返回结果符合 list[PluginToolProviderEntity]。当守护进程返回的数据结构不符合预期时,Pydantic 校验失败,就会抛出上面的解析错误。
Dify 1.17.0 的 docker-compose 配套的是 langgenius/dify-plugin-daemon:0.6.10-local。如果升级时只更新了 API 镜像,而没有同步更新 plugin daemon 镜像,就可能出现这种响应格式不兼容。另有一个相关修复(PR #38265)会规范化旧版守护进程的列表响应,但该规范化只覆盖 PluginListResponse 类型,不覆盖 management/tools 路径,因此守护进程版本不一致时这个接口仍会失败。
另外,正文中先出现的 'text-generation' is not a valid ModelType 与数据库旧数据有关,报告中已通过 SQL 脚本处理,与本条解析错误可能不是同一原因。
环境排查
- 确认 Dify 版本是否为 1.17.0。
- 确认部署方式是否为 Self Hosted(Docker)。
- 执行
docker compose images plugin_daemon,确认守护进程镜像是否真的为0.6.10-local。 - 查看报错时间点附近的 plugin_daemon 容器日志,确认守护进程实际返回的响应结构。
- 确认 API 容器与 plugin daemon 是否在同一次升级中同步更新。
解决步骤
- 检查
docker-compose.yaml中 plugin daemon 的镜像版本,确认是否与 1.17.0 匹配。 - 如果镜像不是
0.6.10-local,将其改为:image: langgenius/dify-plugin-daemon:0.6.10-local - 重启 plugin daemon 容器:
docker compose up -d plugin_daemon - 如果镜像已是
0.6.10-local,保留日志和docker compose images plugin_daemon输出,以便进一步定位守护进程返回的响应结构问题。
验证方法
重启 plugin daemon 后,重新打开此前报错的应用,观察是否仍出现 Failed to parse response from plugin daemon to PluginDaemonBasicResponse [list]。同时可查看 plugin_daemon 日志,确认 management/tools 请求返回正常、无解析异常。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


![[Bug v1.15] Frontend cannot receive reply after Manual Intervention Node + Conditional Branch](https://www.chat-gpts.plus/wp-content/uploads/2026/09/38315-37e2660f-768x403.jpg)