can’t debug model plugins

快速结论：该报错出现在 Dify v1.15.0 自托管环境中，当用户尝试调试模型插件时，插件未显示在模型列表中。优先排查是否为 RBAC 权限门控 Bug，尝试以 admin/owner 用户身份操作。

问题场景

用户在 Dify v1.15.0 自托管环境中调试模型插件（model plugin），但该插件未在模型选择下拉列表中显示，导致无法进行调试。

报错原文

when debug a model plugin, it will not shown in the model list

原因分析

可能原因包括以下几个方向：

• RBAC 权限门控 Bug：v1.15.0 中 web/app/components/plugins/plugin-page/use-reference-setting.ts 的权限逻辑错误地合并了 RBAC 和旧版权限检查，非 admin 用户的调试弹窗可能被隐藏，即使权限设置为“everyone”。
• 缓存未失效：插件模型提供商按租户缓存，基于 generation 进行失效。启动调试会话后可能未正确清理缓存。
• Provider 刷新并发问题：PR #38226 修复了一个并发问题，即插件提供商刷新请求可能冲击插件守护进程，导致提供商加载失败。

环境排查

• Dify 版本：确认是否运行在 v1.15.0，以及是否已应用最新补丁。
• 用户角色：确认当前操作的用户是否为 admin/owner。
• 插件状态：确认插件是否出现在已安装插件列表中，仅未在模型下拉菜单中出现。
• 调试密钥：确认 /workspaces/current/plugin/debugging-key 是否正确配置。
• 浏览器控制台与服务器日志：打开模型列表时，查看是否有错误信息。

解决步骤

1. 优先尝试：使用 admin/owner 账户登录 Dify，再次尝试调试插件，以排除 RBAC 权限 Bug。
2. 清除缓存：强制刷新页面（Ctrl+F5 或 Cmd+Shift+R），或在浏览器开发者工具中清除应用程序缓存。
3. 检查调试密钥：确认插件调试密钥已通过 API 或配置正确设置。
4. 更新版本：确保 Dify v1.15.0 已应用最新补丁或升级到修复了 PR #38226 的版本。
5. 清理并重启：如果上述步骤无效，尝试重启 Dify 服务（包括插件守护进程）。

验证方法

以 admin/owner 用户身份重新打开模型插件调试界面，检查插件是否出现在模型选择下拉列表中。如果出现，则问题已解决。

参考来源

langgenius/dify #38498

AI 工具推荐

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

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

了解 GamsGo AI

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