2026年3月20日dify 正式发布v1.13.2 Latest。这是一个以修复为核心的关键补丁版本主要目标是解决 v1.13.1 中引入的多项严重回归问题和稳定性隐患尤其集中在LLM 调用链路、知识检索节点、插件数据库连接、Weaviate 客户端生命周期管理等生产环境高频场景。对于已经部署 dify 的团队来说1.13.2 不是可选升级而是强烈建议升级的稳定性版本。本文将基于官方发布内容对本次更新进行完整、逐条、无遗漏的技术解读并提供Docker Compose 与源码部署的详细升级步骤帮助你安全完成升级。一、版本概览版本号1.13.2发布时间2026年3月20日版本类型补丁版本Patch Release核心目标修复 v1.13.1 引入的严重回归恢复 LLM 节点与插件调用稳定性修复知识检索节点执行失败问题改善 Weaviate 客户端资源清理提升整体系统运行可靠性二、v1.13.1 中引入的关键问题回顾1. Prompt Message 转换的严重回归问题在 v1.13.1 中Prompt Message 的转换逻辑出现严重回归直接导致多个依赖 LLM 的节点在运行时发生异常。受影响范围包括但不限于LLM 节点Question Classifier问题分类器其他基于 LLM 插件机制的节点该问题的直接后果是Prompt 内容在传递给模型前被错误转换插件调用失败工作流执行中断LLM 节点表现为“无响应”或直接报错这类问题通常只在运行时暴露对生产环境影响极大。v1.13.2 已彻底修复该回归问题并恢复原有的 Prompt Message 转换逻辑。2. Knowledge Retrieval 节点执行失败另一个高频问题出现在Knowledge Retrieval知识检索节点。问题根源在于枚举值发生不兼容变更新旧枚举值之间未正确兼容导致节点在执行阶段直接失败该问题会直接影响基于知识库的问答应用RAG 工作流企业内部知识检索场景在 1.13.2 中已修复所有因枚举不兼容导致的节点执行失败问题确保现有知识库配置无需修改即可正常运行。3. Weaviate 客户端清理逻辑不当在之前版本中Weaviate 客户端存在不合理的销毁逻辑客户端在生命周期结束时被显式调用删除方法实际运行中容易导致连接异常或资源释放问题v1.13.2 对此进行了调整移除 Weaviate 客户端的 del 方法调用避免潜在的连接不稳定和资源异常释放问题这一改动对使用 Weaviate 作为向量数据库的部署尤为重要。4. CreatorUserRole 兼容性问题在 API 层面用户角色字段存在兼容性不足的问题某些场景使用end-user某些场景使用end_user导致角色解析异常v1.13.2 已统一处理CreatorUserRole 同时接受end-user与end_user避免历史数据或第三方集成出现角色校验失败三、重要升级提示务必阅读在升级到 dify 1.13.2 之前请特别注意以下配置要求。1. 自定义 CELERY_QUEUES 的用户如果你使用了自定义CELERY_QUEUES必须确保包含以下队列workflow_based_app_execution否则将导致工作流类应用无法正常执行Worker 进程无法消费对应任务2. ENABLE_API_TOKEN_LAST_USED_UPDATE_TASK 配置如果你启用了ENABLE_API_TOKEN_LAST_USED_UPDATE_TASKtrue那么CELERY_QUEUES 中还必须额外包含api_token否则 API Token 最近使用时间更新任务将无法执行。四、Docker Compose 部署升级指南以下步骤适用于使用 Docker Compose 部署 dify 的场景。1. 备份 docker-compose 配置文件可选但强烈建议进入 docker 目录后执行cddockercpdocker-compose.yaml docker-compose.yaml.$(date%s).bak2. 拉取最新主分支代码gitcheckout maingitpull origin main3. 停止服务请确保在 docker 目录中执行dockercompose down4. 备份数据卷tar-cvfvolumes-$(date%s).tgz volumes5. 启动升级后的服务dockercompose up-d6. 常见错误与解决方案在某些环境中升级后可能遇到如下错误failed to initialize database failed to connect to hostdb_postgres hostname resolving error server misbehaving错误表现为插件数据库初始化失败PostgreSQL 主机名无法解析服务直接 panic 退出解决方式请使用以下命令启动服务dockercompose--profilepostgresql up-d该方式可确保 PostgreSQL 服务正确启动并被依赖服务识别。五、源码部署升级指南如果你使用的是Source Code Deployment源码部署请按照以下流程升级。1. 停止所有服务包括API ServerWorkerWeb Frontend Server2. 切换到 1.13.2 发布分支gitcheckout1.13.23. 更新 Python 依赖cdapi uvsync4. 执行数据库迁移uv run flask db upgrade5. 重新启动所有服务完成以上步骤后重新启动 API、Worker 和 Web 前端服务即可。六、完整变更记录汇总本次 1.13.2 版本包含以下变更内容版本号更新至 1.13.2修复 max_retries 被硬编码的问题修复 fetch_prompt_messages 中 Prompt 内容转换逻辑移除 Weaviate 客户端不当的删除方法CreatorUserRole 同时支持end-user与end_user这些改动虽然看似细节但都直接关系到生产稳定性与兼容性。七、总结为什么必须升级到 dify 1.13.2代码地址github.com/langgenius/difydify 1.13.2 并不是功能堆叠型版本而是一个面向稳定性的关键修复版本适合所有正在运行 dify 1.13.x 的用户。升级后的核心收益包括LLM 节点与插件调用全面恢复稳定知识检索节点不再因枚举问题失败Weaviate 向量数据库连接更可靠API 用户角色兼容性显著提升Docker 与源码部署流程更加清晰、安全
dify 1.13.2 发布：关键回归修复、稳定性全面提升与完整升级实战指南
发布时间：2026/5/28 5:41:52
2026年3月20日dify 正式发布v1.13.2 Latest。这是一个以修复为核心的关键补丁版本主要目标是解决 v1.13.1 中引入的多项严重回归问题和稳定性隐患尤其集中在LLM 调用链路、知识检索节点、插件数据库连接、Weaviate 客户端生命周期管理等生产环境高频场景。对于已经部署 dify 的团队来说1.13.2 不是可选升级而是强烈建议升级的稳定性版本。本文将基于官方发布内容对本次更新进行完整、逐条、无遗漏的技术解读并提供Docker Compose 与源码部署的详细升级步骤帮助你安全完成升级。一、版本概览版本号1.13.2发布时间2026年3月20日版本类型补丁版本Patch Release核心目标修复 v1.13.1 引入的严重回归恢复 LLM 节点与插件调用稳定性修复知识检索节点执行失败问题改善 Weaviate 客户端资源清理提升整体系统运行可靠性二、v1.13.1 中引入的关键问题回顾1. Prompt Message 转换的严重回归问题在 v1.13.1 中Prompt Message 的转换逻辑出现严重回归直接导致多个依赖 LLM 的节点在运行时发生异常。受影响范围包括但不限于LLM 节点Question Classifier问题分类器其他基于 LLM 插件机制的节点该问题的直接后果是Prompt 内容在传递给模型前被错误转换插件调用失败工作流执行中断LLM 节点表现为“无响应”或直接报错这类问题通常只在运行时暴露对生产环境影响极大。v1.13.2 已彻底修复该回归问题并恢复原有的 Prompt Message 转换逻辑。2. Knowledge Retrieval 节点执行失败另一个高频问题出现在Knowledge Retrieval知识检索节点。问题根源在于枚举值发生不兼容变更新旧枚举值之间未正确兼容导致节点在执行阶段直接失败该问题会直接影响基于知识库的问答应用RAG 工作流企业内部知识检索场景在 1.13.2 中已修复所有因枚举不兼容导致的节点执行失败问题确保现有知识库配置无需修改即可正常运行。3. Weaviate 客户端清理逻辑不当在之前版本中Weaviate 客户端存在不合理的销毁逻辑客户端在生命周期结束时被显式调用删除方法实际运行中容易导致连接异常或资源释放问题v1.13.2 对此进行了调整移除 Weaviate 客户端的 del 方法调用避免潜在的连接不稳定和资源异常释放问题这一改动对使用 Weaviate 作为向量数据库的部署尤为重要。4. CreatorUserRole 兼容性问题在 API 层面用户角色字段存在兼容性不足的问题某些场景使用end-user某些场景使用end_user导致角色解析异常v1.13.2 已统一处理CreatorUserRole 同时接受end-user与end_user避免历史数据或第三方集成出现角色校验失败三、重要升级提示务必阅读在升级到 dify 1.13.2 之前请特别注意以下配置要求。1. 自定义 CELERY_QUEUES 的用户如果你使用了自定义CELERY_QUEUES必须确保包含以下队列workflow_based_app_execution否则将导致工作流类应用无法正常执行Worker 进程无法消费对应任务2. ENABLE_API_TOKEN_LAST_USED_UPDATE_TASK 配置如果你启用了ENABLE_API_TOKEN_LAST_USED_UPDATE_TASKtrue那么CELERY_QUEUES 中还必须额外包含api_token否则 API Token 最近使用时间更新任务将无法执行。四、Docker Compose 部署升级指南以下步骤适用于使用 Docker Compose 部署 dify 的场景。1. 备份 docker-compose 配置文件可选但强烈建议进入 docker 目录后执行cddockercpdocker-compose.yaml docker-compose.yaml.$(date%s).bak2. 拉取最新主分支代码gitcheckout maingitpull origin main3. 停止服务请确保在 docker 目录中执行dockercompose down4. 备份数据卷tar-cvfvolumes-$(date%s).tgz volumes5. 启动升级后的服务dockercompose up-d6. 常见错误与解决方案在某些环境中升级后可能遇到如下错误failed to initialize database failed to connect to hostdb_postgres hostname resolving error server misbehaving错误表现为插件数据库初始化失败PostgreSQL 主机名无法解析服务直接 panic 退出解决方式请使用以下命令启动服务dockercompose--profilepostgresql up-d该方式可确保 PostgreSQL 服务正确启动并被依赖服务识别。五、源码部署升级指南如果你使用的是Source Code Deployment源码部署请按照以下流程升级。1. 停止所有服务包括API ServerWorkerWeb Frontend Server2. 切换到 1.13.2 发布分支gitcheckout1.13.23. 更新 Python 依赖cdapi uvsync4. 执行数据库迁移uv run flask db upgrade5. 重新启动所有服务完成以上步骤后重新启动 API、Worker 和 Web 前端服务即可。六、完整变更记录汇总本次 1.13.2 版本包含以下变更内容版本号更新至 1.13.2修复 max_retries 被硬编码的问题修复 fetch_prompt_messages 中 Prompt 内容转换逻辑移除 Weaviate 客户端不当的删除方法CreatorUserRole 同时支持end-user与end_user这些改动虽然看似细节但都直接关系到生产稳定性与兼容性。七、总结为什么必须升级到 dify 1.13.2代码地址github.com/langgenius/difydify 1.13.2 并不是功能堆叠型版本而是一个面向稳定性的关键修复版本适合所有正在运行 dify 1.13.x 的用户。升级后的核心收益包括LLM 节点与插件调用全面恢复稳定知识检索节点不再因枚举问题失败Weaviate 向量数据库连接更可靠API 用户角色兼容性显著提升Docker 与源码部署流程更加清晰、安全
