Dify 报错排查

Dify 模型供应商配置失败怎么办?按这个顺序排查

Dify 接入 OpenAI 兼容接口失败时,最常见的问题是供应商类型选错、Base URL 路径不完整、模型名称不存在或 API Key 无效。

快速检查清单

  1. 供应商类型选择 OpenAI-compatible。
  2. Base URL 填写 https://b.onerouter.com/openai/v1
  3. API Key 完整复制,没有空格和换行。
  4. 模型名称与控制台支持列表一致。
  5. 账户余额足够,Key 没有被禁用。

模型名称错误

如果 Dify 提示模型不存在,通常是模型名写错。建议先在控制台确认可用模型,再复制到 Dify。

连接失败

如果是网络连接失败,先用浏览器或 curl 测试域名是否能访问,再检查服务器环境是否允许外部请求。

建议

配置成功后,先创建一个最简单的聊天应用测试,不要一开始就接知识库和复杂工作流。这样更容易定位问题。