dify 1.13.2 发布：关键回归修复、稳定性全面提升与完整升级实战指南

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_TASK=true

那么CELERY_QUEUES 中还必须额外包含：

•api_token

否则 API Token 最近使用时间更新任务将无法执行。

四、Docker Compose 部署升级指南

以下步骤适用于使用 Docker Compose 部署 dify 的场景。

1. 备份 docker-compose 配置文件（可选但强烈建议）

进入 docker 目录后执行：

cd docker
cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak

2. 拉取最新主分支代码

git checkout main
git pull origin main

3. 停止服务

请确保在 docker 目录中执行：

docker compose down

4. 备份数据卷

tar -cvf volumes-$(date +%s).tgz volumes

5. 启动升级后的服务

docker compose up -d

6. 常见错误与解决方案

在某些环境中，升级后可能遇到如下错误：

failed to initialize database
failed to connect to host=db_postgres
hostname resolving error
server misbehaving

错误表现为：

• 插件数据库初始化失败

• PostgreSQL 主机名无法解析

• 服务直接 panic 退出

解决方式：请使用以下命令启动服务：

docker compose --profile postgresql up -d

该方式可确保 PostgreSQL 服务正确启动并被依赖服务识别。

五、源码部署升级指南

如果你使用的是Source Code Deployment（源码部署），请按照以下流程升级。

1. 停止所有服务

包括：

• API Server

• Worker

• Web Frontend Server

2. 切换到 1.13.2 发布分支

git checkout 1.13.2

3. 更新 Python 依赖

cd api
uv sync

4. 执行数据库迁移

uv run flask db upgrade

5. 重新启动所有服务

完成以上步骤后，重新启动 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/dify

dify 1.13.2 并不是功能堆叠型版本，而是一个面向稳定性的关键修复版本，适合所有正在运行 dify 1.13.x 的用户。

升级后的核心收益包括：

• LLM 节点与插件调用全面恢复稳定

• 知识检索节点不再因枚举问题失败

• Weaviate 向量数据库连接更可靠

• API 用户角色兼容性显著提升

• Docker 与源码部署流程更加清晰、安全

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。