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 与源码部署流程更加清晰、安全