Harness 与 Agent 工程 · 日志、监控与故障定位 · 2026-08-26

Dify 1.17.0 上线第一天,生产环境全炸了

Dify 1.17.0上线首日生产事故频发,模型全崩的真实踩坑经历与修复方案,助你快速避坑。 核心内容:

  1. 模型全挂的生产事故症状(无法加载及Issue反馈)
  2. 枚举值修改未兼容旧数据的根因分析
  3. 手动执行SQL修复数据库的具体方案

昨天 Dify 1.17.0 正式发布,E2B 云沙箱、Skill 管理、工作流变量复用,功能确实很香。

但如果你正准备升级,先别急——GitHub Issues 已经炸了。

这篇文章不讲新功能,专门聊 1.17.0 生产部署的真实踩坑,帮你省掉排查时间。

坑一:升级后模型全挂了,一个都加载不出来

这是目前最严重的生产问题,Issue #41294 昨天刚报出来,评论区一片哀嚎。

症状:升级到 1.17.0 后,「集成管理」里的模型插件全部无法加载,默认模型配置页面直接崩掉。

根因:从 1.14.x 开始,Dify 内部把 model_type 的枚举值改了——text-generation 改成 llm,embeddings 改成 text-embedding,reranking 改成 rerank。问题是,数据库里已经存好的旧值没有自动迁移。

API 启动时读到旧的枚举值,直接抛 ValueError: 'text-generation' is not a valid ModelType,模型列表页面一片空白。

社区原话:「是谁闲的没事把旧的枚举值改了,能兼容就兼容啊」「不测试的吗?」

修复方案:

先备份数据库,然后手动跑 SQL:

-- provider_models 表UPDATE provider_models SET model_type = 'llm' WHERE model_type = 'text-generation';UPDATE provider_models SET model_type = 'text-embedding' WHERE model_type = 'embeddings';UPDATE provider_models SET model_type = 'rerank' WHERE model_type = 'reranking';-- provider_model_credentials 表UPDATE provider_model_credentials SET model_type = 'llm' WHERE model_type = 'text-generation';UPDATE provider_model_credentials SET model_type = 'text-embedding' WHERE model_type = 'embeddings';UPDATE provider_model_credentials SET model_type = 'rerank' WHERE model_type = 'reranking';-- tenant_default_models 表(可能有唯一约束冲突)DELETE FROM tenant_default_models WHERE model_type IN ('text-generation', 'embeddings', 'reranking');-- provider_model_settings 表UPDATE provider_model_settings SET model_type = 'llm' WHERE model_type = 'text-generation';UPDATE provider_model_settings SET model_type = 'text-embedding' WHERE model_type = 'embeddings';UPDATE provider_model_settings…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/dify/2026082639048.html